README Badges Implementation Plan
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
Goal: Add 10 badges to the top of README.md showing CI status, code quality, tech stack, and project info.
Architecture: Pure markdown edit — insert badge rows before the # server-maintanence heading. Codacy badge uses a placeholder token until the user provides the real one from their Codacy dashboard.
Tech Stack: Markdown, shields.io, GitHub Actions status badges, Codecov, Codacy
Task 1: Add badges to README.md and commit
Files:
- Modify:
README.md:1(insert badge block before the heading) - Modify:
docs/plans/2026-02-15-readme-badges-design.md(already exists, no changes needed)
Step 1: Insert badge block at the top of README.md
Replace line 1 of README.md:
# server-maintanence
With:
[](https://github.com/ikidnapmyself/server-monitoring/actions/workflows/ci.yml)
[](https://github.com/ikidnapmyself/server-monitoring/actions/workflows/security.yml)
[](https://codecov.io/gh/ikidnapmyself/server-monitoring)
[](https://app.codacy.com/gh/ikidnapmyself/server-monitoring/dashboard)
[](https://www.python.org/downloads/)
[](https://www.djangoproject.com/)
[](https://github.com/psf/black)
[](https://github.com/astral-sh/ruff)
[](https://github.com/ikidnapmyself/server-monitoring/blob/main/LICENSE)
[](https://pre-commit.com/)
# server-maintanence
Step 2: Verify the README renders correctly
Run: head -15 README.md Expected: Badge markdown lines followed by the heading.
Step 3: Commit
git add README.md docs/plans/2026-02-15-readme-badges-design.md
git commit -m "docs: add CI, quality, tech stack, and project badges to README"
Post-implementation: Codacy token
After committing, the user needs to:
- Go to https://app.codacy.com/gh/ikidnapmyself/server-monitoring/dashboard
- Navigate to Settings > General > Badge
- Copy the project token
- Replace
CODACY_PROJECT_TOKENin the Codacy badge URL inREADME.md