{"id":48305802,"url":"https://github.com/baseinfinity/agentic-ai-sdlc-wizard","last_synced_at":"2026-04-20T01:01:19.374Z","repository":{"id":333407626,"uuid":"1137181648","full_name":"BaseInfinity/agentic-ai-sdlc-wizard","owner":"BaseInfinity","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-17T02:37:04.000Z","size":1825,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T04:03:16.057Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BaseInfinity.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"BaseInfinity"}},"created_at":"2026-01-19T03:02:12.000Z","updated_at":"2026-04-17T02:37:08.000Z","dependencies_parsed_at":"2026-04-17T04:01:40.168Z","dependency_job_id":null,"html_url":"https://github.com/BaseInfinity/agentic-ai-sdlc-wizard","commit_stats":null,"previous_names":["baseinfinity/sdlc-wizard","baseinfinity/agentic-ai-sdlc-wizard"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/BaseInfinity/agentic-ai-sdlc-wizard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaseInfinity%2Fagentic-ai-sdlc-wizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaseInfinity%2Fagentic-ai-sdlc-wizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaseInfinity%2Fagentic-ai-sdlc-wizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaseInfinity%2Fagentic-ai-sdlc-wizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BaseInfinity","download_url":"https://codeload.github.com/BaseInfinity/agentic-ai-sdlc-wizard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaseInfinity%2Fagentic-ai-sdlc-wizard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32028547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"ssl_error","status_checked_at":"2026-04-20T00:17:31.068Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-05T00:02:23.385Z","updated_at":"2026-04-20T01:01:19.368Z","avatar_url":"https://github.com/BaseInfinity.png","language":"Shell","funding_links":["https://github.com/sponsors/BaseInfinity"],"categories":[],"sub_categories":[],"readme":"# Claude Code SDLC Wizard\n\nA **self-evolving Software Development Life Cycle (SDLC) enforcement system for AI coding agents**. Makes Claude plan before coding, test before shipping, and ask when uncertain. Measures itself getting better over time.\n\n**Built on 15+ years of software engineering and founding engineering experience** — battle-tested patterns from real production systems, baked into an AI agent that follows tried-and-true software quality practices so you don't have to enforce them manually.\n\n## Install\n\n**Requires [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview)** (Anthropic's CLI for Claude).\n\nRun from your terminal or from inside Claude Code (`!` prefix):\n```bash\nnpx agentic-sdlc-wizard init\n```\nThen start (or restart) Claude Code — type `/exit` then `claude` to reload hooks. Setup auto-invokes on first prompt — Claude reads the wizard doc, scans your project, and generates bespoke CLAUDE.md, SDLC.md, TESTING.md, and ARCHITECTURE.md. No manual commands needed.\n\n\u003cdetails\u003e\n\u003csummary\u003eAlternative install methods\u003c/summary\u003e\n\n**curl (no npm install needed):**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/BaseInfinity/agentic-ai-sdlc-wizard/main/install.sh | bash\n```\n\n**Homebrew:**\n```bash\nbrew install BaseInfinity/sdlc-wizard/sdlc-wizard\nsdlc-wizard init\n```\n\n**GitHub CLI extension:**\n```bash\ngh extension install BaseInfinity/gh-sdlc-wizard\ngh sdlc-wizard init\n```\n\n**From GitHub (no npm registry needed):**\n```bash\nnpx github:BaseInfinity/agentic-ai-sdlc-wizard init\n```\n\n**Install CLI globally:**\n```bash\nnpm install -g agentic-sdlc-wizard\nsdlc-wizard init\n```\n\n**Manual:** Download `CLAUDE_CODE_SDLC_WIZARD.md` to your project and tell Claude `Run the SDLC wizard setup`.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eHealth check \u0026 updates\u003c/summary\u003e\n\n```bash\nnpx agentic-sdlc-wizard check        # Human-readable\nnpx agentic-sdlc-wizard check --json  # Machine-readable (CI-friendly)\n```\n\nReports MATCH / CUSTOMIZED / MISSING / DRIFT for every installed file. Exits non-zero on MISSING or DRIFT — use in CI to catch setup regressions.\n\n**Check for content updates:** Tell Claude `Check if the SDLC wizard has updates` — it reads [CHANGELOG.md](CHANGELOG.md), shows what's new, and offers to apply changes.\n\u003c/details\u003e\n\n## Why Use This\n\nYou want Claude Code to follow engineering discipline automatically:\n- **Plan before coding** (not guess-and-check)\n- **Write tests first** (TDD enforced via hooks)\n- **State confidence** (LOW = ask user, don't guess)\n- **Track work visibly** (TaskCreate)\n- **Self-review before presenting**\n- **Prove it's better** (use native features unless you prove custom wins)\n\nThe wizard auto-detects your stack (package.json, test framework, deployment targets) and generates bespoke hooks + skills + docs. CI validates the generated assets; cross-stack setup-path E2E is on the [roadmap](ROADMAP.md).\n\n## What This Actually Is\n\nFive layers working together:\n\n```\nLayer 5: SELF-IMPROVEMENT\n  Weekly/monthly workflows detect changes, test them\n  statistically, create PRs. Baselines evolve organically.\n\nLayer 4: STATISTICAL VALIDATION\n  E2E scoring with 95% CI (5 trials, t-distribution).\n  SDP normalizes for model quality. CUSUM catches drift.\n\nLayer 3: SCORING ENGINE\n  Multi-criteria scoring, 10/11 points. Claude evaluates Claude.\n  Before/after wizard A/B comparison in CI.\n\nLayer 2: ENFORCEMENT\n  Hooks fire every interaction (~100 tokens).\n  PreToolUse reminds Claude to write tests first.\n\nLayer 1: PHILOSOPHY\n  The wizard document. KISS. TDD. Confidence levels.\n  Copy it, run setup, get a bespoke SDLC.\n```\n\n## What Makes This Different\n\n| Capability | What It Does |\n|---|---|\n| **E2E scoring in CI** | Every PR gets an automated SDLC compliance score (0-10) — measures whether Claude actually planned, tested, and reviewed |\n| **Before/after A/B testing** | Compares wizard changes against a baseline with 95% confidence intervals to prove improvements aren't noise |\n| **SDP normalization** | Separates \"the model had a bad day\" from \"our SDLC broke\" by cross-referencing external benchmarks |\n| **CUSUM drift detection** | Catches gradual quality decay over time — borrowed from manufacturing quality control |\n| **Pre-tool TDD hooks** | Before source edits, a hook reminds Claude to write tests first. CI scoring checks whether it actually followed TDD |\n| **Self-evolving loop** | Weekly/monthly external research + local CI shepherd loop — you approve, the system gets better |\n\n## How It Works\n\n**Think Iron Man:** Jarvis is nothing without Tony Stark. Tony Stark is still Tony Stark. But together? They make Iron Man. This SDLC is your suit - you build it over time, improve it for your needs, and it makes you both better.\n\n**The dream:** Mold an ever-evolving SDLC to your needs. Replace my components with native Claude Code features as they ship — and one day, delete this repo entirely because Claude Code has them all built in. That's the goal.\n\n```\nWIZARD FILE (CLAUDE_CODE_SDLC_WIZARD.md)\n  - Setup guide, used once\n  - Lives on GitHub, fetched when needed\n        |\n        | generates\n        v\nGENERATED FILES (in your repo)\n  - .claude/hooks/*.sh\n  - .claude/skills/*/SKILL.md\n  - .claude/settings.json\n  - CLAUDE.md, SDLC.md, TESTING.md, ARCHITECTURE.md\n        |\n        | validated by\n        v\nCI/CD PIPELINE\n  - E2E: simulate SDLC task -\u003e score 0-10\n  - Before/after: main vs PR wizard\n  - Statistical: 5x trials, 95% CI\n  - Model-aware: SDP adjusts for external conditions\n```\n\n## Self-Evolving System\n\n| Cadence | Source | Action |\n|---------|--------|--------|\n| Weekly | Claude Code releases | PR with analysis + E2E test |\n| Weekly | Community (Reddit, HN) | Issue digest |\n| Monthly | Deep research, papers | Trend report |\n\nEvery update: regression tested -\u003e AI reviewed -\u003e human approved.\n\n## E2E Scoring\n\nLike evaluating scientific method adherence - we measure **process compliance**:\n\n| Criterion | Points | Type |\n|-----------|--------|------|\n| TodoWrite/TaskCreate | 1 | Deterministic |\n| Confidence stated | 1 | Deterministic |\n| Plan mode | 2 | AI-judge |\n| TDD RED | 2 | Deterministic |\n| TDD GREEN | 2 | AI-judge |\n| Self-review | 1 | AI-judge |\n| Clean code | 1 | AI-judge |\n\n40% deterministic + 60% AI-judged. 5 trials handle variance.\n\n## Model-Adjusted Scoring (SDP)\n\n| Metric | Meaning |\n|--------|---------|\n| **Raw** | Actual score (Layer 2: SDLC compliance) |\n| **SDP** | Adjusted for model conditions |\n| **Robustness** | How well SDLC holds up vs model changes |\n\n- **Robustness \u003c 1.0** = SDLC is resilient (good!)\n- **Robustness \u003e 1.0** = SDLC is sensitive (investigate)\n\n## Tests Are The Building Blocks\n\nTests aren't just validation - they're the foundation everything else builds on.\n\n- **Tests \u003e= App Code** - Critique tests as hard (or harder) than implementation\n- **Tests prove correctness** - Without them, you're just hoping\n- **Tests enable fearless change** - Refactor confidently\n\n## Official Plugin Integration\n\n| Plugin | Purpose | Scope |\n|--------|---------|-------|\n| `claude-md-management` | **Required** - CLAUDE.md maintenance | CLAUDE.md only |\n| `claude-code-setup` | Recommends automations | Recommendations |\n| `code-review` | Local self-review and PR review (optional) | Local + PRs |\n\n## Prove It's Better\n\nDon't reinvent the wheel. Use native/built-in features UNLESS you prove your custom version is better. If you can't prove it, delete yours.\n\n1. Test the native solution — measure quality, speed, reliability\n2. Test your custom solution — same scenario, same metrics\n3. Compare side-by-side\n4. Native \u003e= custom? **Use native. Delete yours.**\n5. Custom \u003e native? **Keep yours. Document WHY.** Re-evaluate when native improves.\n\nThis applies to everything: native commands vs custom skills, framework utilities vs hand-rolled code, library functions vs custom implementations.\n\n## How This Compares\n\nThis isn't the only Claude Code SDLC tool. Here's an honest comparison:\n\n| Aspect | SDLC Wizard | everything-claude-code | claude-sdlc |\n|--------|------------|----------------------|-------------|\n| **Focus** | SDLC enforcement + measurement | Agent performance optimization | Plugin marketplace |\n| **Hooks** | 3 (SDLC, TDD, instructions) | 12+ (dev blocker, prettier, etc.) | Webhook watcher |\n| **Skills** | 4 (/sdlc, /setup, /update, /feedback) | 80+ domain-specific | 13 slash commands |\n| **Evaluation** | 95% CI, CUSUM, SDP, Tier 1/2 | Configuration testing | skilltest framework |\n| **CI Shepherd** | Local CI fix loop | No | No |\n| **Auto-updates** | Weekly CC + community scan | No | No |\n| **Install** | `npx agentic-sdlc-wizard init` | npm install | npm install |\n| **Philosophy** | Lightweight, prove-it-or-delete | Scale and optimization | Documentation-first |\n\n**Our unique strengths:** Statistical rigor (CUSUM + 95% CI), SDP scoring (model quality vs SDLC compliance), CI shepherd loop, Prove-It A/B pipeline, comprehensive automated test suite, dogfooding enforcement.\n\n**Where others are stronger:** everything-claude-code has broader language/framework coverage. claude-sdlc has webhook-driven automation. Both have npm distribution.\n\n**The spirit:** Open source — we learn from each other. See [COMPETITIVE_AUDIT.md](COMPETITIVE_AUDIT.md) for details.\n\n## Documentation\n\n| Document | What It Covers |\n|----------|---------------|\n| [ARCHITECTURE.md](ARCHITECTURE.md) | System design, 5-layer diagram, data flows, file structure |\n| [CI_CD.md](CI_CD.md) | All workflows, E2E scoring, tier system, SDP, integrity checks |\n| [SDLC.md](SDLC.md) | Version tracking, enforcement rules, SDLC configuration |\n| [TESTING.md](TESTING.md) | Testing philosophy, test diamond, TDD approach |\n| [CHANGELOG.md](CHANGELOG.md) | Version history, what changed and when |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute, evaluation methodology |\n\n## Community\n\nCome join **[Automation Station](https://discord.com/invite/fGPEF7GHrF)** — a community Discord packed with software engineers bringing 40+ years of combined experience across every area of the stack (frontend, backend, infra, embedded, data, QA, DevOps, you name it). Share patterns, ask questions, compare notes on AI agents, automation, and SDLC tooling.\n\n## Contributing\n\nPRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for evaluation methodology and testing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaseinfinity%2Fagentic-ai-sdlc-wizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbaseinfinity%2Fagentic-ai-sdlc-wizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaseinfinity%2Fagentic-ai-sdlc-wizard/lists"}