Skip to content
Back to search

ai-sdlc

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ai-sdlc-framework/ai-sdlc with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ai-sdlc-framework/ai-sdlc'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ai-sdlc-framework--ai-sdlc/badge.svg)](/listings/ai-sdlc-framework--ai-sdlc)

HTML

<a href="/listings/ai-sdlc-framework--ai-sdlc"><img src="/api/listings/ai-sdlc-framework--ai-sdlc/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 1. Install the Claude Code plugin (recommended)
/plugin marketplace add ai-sdlc-framework/ai-sdlc
/plugin install ai-sdlc@ai-sdlc
/reload-plugins

# 2. Scaffold your repository
ai-sdlc init

# 3. Check the install and configuration are healthy
ai-sdlc doctor

# 4. Dispatch your first task
/ai-sdlc execute AISDLC-42

Full setup, runner configuration, agent-runner reference, and the session-hierarchy setup are in the documentation:

→ [Getting Started](https://ai-sdlc.io/docs/getting-started?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-getting-started) · [Tutorials](https://ai-sdlc.io/docs/tutorials?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-tutorials) · [API Reference](https://ai-sdlc.io/docs/api-reference?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-api-reference) · [Operations Runbooks](docs/operations/)

The framework is agent-agnostic — Claude Code, Codex, Cursor, Copilot, Aider, or any OpenAI-compatible API. See the [Agent Runner Reference](https://ai-sdlc.io/docs/api-reference/runners?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-api-reference-runners).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "ai-sdlc",
  3. "owner": {
  4. "name": "AI-SDLC Framework",
  5. "url": "https://ai-sdlc.io"
  6. },
  7. "plugins": [
  8. {
  9. "name": "ai-sdlc",
  10. "source": "./ai-sdlc-plugin",
  11. "description": "AI-SDLC governance framework for Claude Code — action enforcement, telemetry, quality gates, review agents, and MCP tools",
  12. "version": "0.42.0"
  13. }
  14. ]
  15. }
README.md · README · 171 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # AI-SDLC Framework
  3. **The Decision Engine for spec-driven AI workflows**
  4. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
  5. [![CI](https://github.com/ai-sdlc-framework/ai-sdlc/actions/workflows/ci.yml/badge.svg)](https://github.com/ai-sdlc-framework/ai-sdlc/actions/workflows/ci.yml)
  6. [![Spec Version](https://img.shields.io/badge/spec-v1alpha1-orange.svg)](#specification--versioning)
  7. [![Coverage](https://codecov.io/gh/ai-sdlc-framework/ai-sdlc/branch/main/graph/badge.svg)](https://codecov.io/gh/ai-sdlc-framework/ai-sdlc)
  8. [![Docs](https://img.shields.io/badge/docs-ai--sdlc.io-0a0a0a.svg)](https://ai-sdlc.io/docs?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=badge-docs)
  9. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
  10. [Website](https://ai-sdlc.io?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=header-home) · [Documentation](https://ai-sdlc.io/docs?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=header-docs) · [Specification](https://ai-sdlc.io/docs/spec/spec?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=header-docs-spec-spec) · [Getting Started](https://ai-sdlc.io/docs/getting-started?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=header-docs-getting-started) · [Vision](VISION.md) · [Contributing](CONTRIBUTING.md)
  11. </div>
  12. ---
  13. ## What this is
  14. AI-SDLC is the **Decision Engine** for spec-driven AI workflows — the execution-and-governance half of a spec-driven development stack. Operators frontload the load-bearing decisions through a Definition-of-Ready gate; a session hierarchy (`cli-hierarchy`) dispatches developer subagents through the dependency graph; cross-harness reviewers (Claude × Codex × …) verify the work in parallel; DSSE attestations seal every change; pull requests open themselves.
  15. The leverage move is **cost asymmetry**: operator decisions made upfront — with full context, time to think, and access to stakeholders — are cheap and (mostly) correct. AI decisions made mid-execution under uncertainty are expensive and often wrong. The framework's value is not "AI writes code"; it's **"AI executes well-specified contracts deterministically."** Those are different products with different reliability profiles.
  16. The operator's role shifts to **decision steward** — frame open questions, resolve them, sign off on resolutions, monitor the pipeline. Typing and rubber-stamping go to the framework.
  17. AI-SDLC covers the **contract → shipped** half of the spec-driven funnel. Front-of-funnel tools like [GitHub Spec Kit](https://github.com/github/spec-kit) cover **idea → contract**; the two systems compose at the seam where a spec artifact becomes a backlog task ready for DoR. See [RFC-0036](spec/rfcs/RFC-0036-spec-kit-bridge-adopter-authoring.md) for the bridge design and adopter authoring model.
  18. > **Read first:** [`VISION.md`](VISION.md) is the organizing thesis — the design philosophy that grounds every RFC, every CLI, every gate. If something in this repo doesn't trace back to one of its principles, that's a signal we've drifted.
  19. ---
  20. ## The problem AI-SDLC solves
  21. AI agents can build small greenfield projects, but software falls apart as it grows. The data is consistent:
  22. - **Productivity paradox** — Experienced developers using AI tools are 19% slower on mature codebases, despite believing they are 20% faster ([METR 2025](https://metr.org))
  23. - **Quality decline** — Refactoring dropped from 25% to 10% of changes; code churn rose from 5.5% to 7.9% ([GitClear 2024](https://www.gitclear.com))
  24. - **Stability regression** — Every 25% increase in AI adoption correlates with a 7.2% drop in system stability ([Google DORA 2024](https://dora.dev))
  25. - **Trust gap** — Only 3% of developers express high trust in AI output ([Stack Overflow 2025](https://survey.stackoverflow.co))
  26. The root cause is not that AI agents write bad code. It is that **nobody orchestrates how they work as the codebase grows** — every decision gets deferred to the worst possible moment, made by the actor with the least context. AI-SDLC flips that.
  27. ---
  28. ## The five pillars
  29. The framework is one cohesive system, but it ships as five pillars you can adopt incrementally.
  30. ### 1. The Decision Engine — [RFC-0011](spec/rfcs/RFC-0011-definition-of-ready-gate.md) · [RFC-0035](spec/rfcs/RFC-0035-decision-catalog-operator-routing.md)
  31. A Definition-of-Ready gate (RFC-0011) refuses to dispatch tasks the operator hasn't actually decided yet. The shipped Decision Catalog (RFC-0035, `cli-decisions`) makes the operator's open-question queue a first-class resource — ranked by leverage, routed to the right actor, surfaced with framework recommendations + counter-arguments + sub-decision graphs. The framework recommends; the operator decides; the dispatch session executes. → [Concept page](https://ai-sdlc.io/docs/concepts/dor-gate?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-concepts-dor-gate)
  32. ### 2. Session Hierarchy — [RFC-0051](spec/rfcs/RFC-0051-session-hierarchy-parallel-dispatch.md)
  33. `cli-hierarchy up` starts a planner, a dispatch session and up to five executors, each a Claude Code session in its own tmux session. Dispatch walks the dependency graph (RFC-0014), admits tasks past the blocked, in-flight, DoR and dispatchability filters, and hands each to an executor in an isolated git worktree, which runs the Step 0-13 pipeline (dev agent → configured reviewers → attestation sign → PR open). Operators monitor; they don't type. → [Concept page](https://ai-sdlc.io/docs/concepts/autonomous-orchestrator?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-concepts-autonomous-orchestrator) · [Runbook](docs/operations/cli-hierarchy.md)
  34. ### 3. Cross-Harness Review — [RFC-0010](spec/rfcs/RFC-0010-parallel-execution-worktree-pooling.md) §13
  35. The configured reviewer set (`.ai-sdlc/review-policy.md`, `reviewer-set-flag`) runs in parallel on every change. DSSE envelopes carry a `harness` field that identifies the execution harness behind each review, and `verify-attestation` enforces **independence by construction**: if Claude implemented, Claude cannot also be the code or test reviewer. Codex reviews Claude's work and vice versa. Reviewer collusion is mechanically impossible. → [Concept page](https://ai-sdlc.io/docs/concepts/cross-harness-review?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-concepts-cross-harness-review) · [Runbook](docs/operations/cross-harness-review.md)
  36. ### 4. Operator Surface — [RFC-0051](spec/rfcs/RFC-0051-session-hierarchy-parallel-dispatch.md) · [RFC-0035](spec/rfcs/RFC-0035-decision-catalog-operator-routing.md)
  37. The operator works through `cli-hierarchy` (`status`, `attach`, `brief`, `down`) and the Decision Catalog (`cli-decisions`), which foregrounds load-bearing decisions and stays out of the way for the rest. → [Reference](docs/operations/cli-hierarchy.md)
  38. ### 5. Declarative Governance
  39. Declarative resources for the whole lifecycle: `Pipeline`, `Decision`, `AgentRole`, `QualityGate`, `AutonomyPolicy`, `AdapterBinding` — all with JSON Schema (draft 2020-12) under [`spec/schemas/`](spec/schemas/). Quality gates run advisory → soft-mandatory → hard-mandatory with cross-harness review and DSSE attestation. Adopters declare a compliance posture ([RFC-0022](spec/rfcs/RFC-0022-compliance-posture-audit-surface.md)) and the framework derives gate defaults — EU AI Act, NIST AI RMF, ISO 42001. → [Specification](spec/spec.md)
  40. ---
  41. ## Getting started
  42. ```bash
  43. # 1. Install the Claude Code plugin (recommended)
  44. /plugin marketplace add ai-sdlc-framework/ai-sdlc
  45. /plugin install ai-sdlc@ai-sdlc
  46. /reload-plugins
  47. # 2. Scaffold your repository
  48. ai-sdlc init
  49. # 3. Check the install and configuration are healthy
  50. ai-sdlc doctor
  51. # 4. Dispatch your first task
  52. /ai-sdlc execute AISDLC-42
  53. ```
  54. Full setup, runner configuration, agent-runner reference, and the session-hierarchy setup are in the documentation:
  55. → [Getting Started](https://ai-sdlc.io/docs/getting-started?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-getting-started) · [Tutorials](https://ai-sdlc.io/docs/tutorials?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-tutorials) · [API Reference](https://ai-sdlc.io/docs/api-reference?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-api-reference) · [Operations Runbooks](docs/operations/)
  56. The framework is agent-agnostic — Claude Code, Codex, Cursor, Copilot, Aider, or any OpenAI-compatible API. See the [Agent Runner Reference](https://ai-sdlc.io/docs/api-reference/runners?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=body-docs-api-reference-runners).
  57. ---
  58. ## For AI agents and human contributors discovering this repo
  59. If you are an AI agent or a new contributor coming to this codebase for the first time, read these documents in order. Each is canonical for its concern:
  60. 1. **[`VISION.md`](VISION.md)** — the organizing thesis (Decision Engine, cost asymmetry, operator-as-decision-steward, anti-patterns ruled out). Every decision in this repo should trace back here.
  61. 2. **[`CLAUDE.md`](CLAUDE.md)** — operating conventions for any agent or contributor working in this repo: git flow (always rebase, never merge), branch + commit conventions, pre-push hooks, attestation requirements, backlog workflow, Pattern-C worktree isolation, plugin MCP routing. **Load this before doing any work.**
  62. 3. **[`CHARTER.md`](CHARTER.md)** — project governance, IP policy, CNCF alignment.
  63. 4. **[`spec/rfcs/README.md`](spec/rfcs/README.md)** — the architectural decisions registry. Every load-bearing design choice lives as an RFC. The registry table is the canonical lookup for numbers and lifecycle states; the Critical Path section traces dependencies.
  64. 5. **[`spec/spec.md`](spec/spec.md)** + **[`spec/`](spec/)** — the normative specification: resource model, policy enforcement, autonomy, agents, adapters, metrics.
  65. Canonical execution paths (when working inside a Claude Code session):
  66. | Use case | Command | Billing |
  67. |---|---|---|
  68. | Internal dogfood (backlog tasks) | `/ai-sdlc execute <task-id>` | Subscription |
  69. | Manual cleanup | `/ai-sdlc cleanup [<task-id>]` | n/a |
  70. | Autonomous drain (session hierarchy) | `/ai-sdlc hierarchy up` | Subscription |
  71. | GitHub issue / unattended / CI | `pnpm --filter @ai-sdlc/dogfood watch --issue <id>` | API key |
  72. Rules of thumb to internalize before pushing code:
  73. - **Merging follows `governance.allowMerge`** in `.ai-sdlc/agent-role.yaml`, rendered into the session hard rules; when it permits merging, the only path is `cli-merge-if-eligible`; never run the raw merge command.
  74. - **Always rebase** feature branches onto main. Never merge main in.
  75. - **Pattern C**: the parent working tree is read-only. All code work happens in `.worktrees/<task-id>/`. `/ai-sdlc execute` sets this up automatically.
  76. - **Attestation is required** on `main`. Code PRs that touch source must carry a DSSE envelope signed by the reviewer chain. Docs-only PRs bypass. See the [review policy](docs/operations/review-policy.md) for what counts as a review, and the [independence policy](docs/operations/independence-policy.md) (`.ai-sdlc/independence-policy.yaml` `requiredTier`) to enforce reviewer independence.
  77. - **Cross-repo writes** go through `permittedExternalPaths` in the task frontmatter.
  78. The plugin's slash commands and MCP tools are documented in [`ai-sdlc-plugin/README.md`](ai-sdlc-plugin/README.md). The Step 0-13 pipeline is in [`pipeline-cli/README.md`](pipeline-cli/README.md).
  79. ---
  80. ## Packages
  81. | Package | Path | Purpose |
  82. |---|---|---|
  83. | `@ai-sdlc/orchestrator` | [`orchestrator/`](orchestrator/) | Orchestrator runtime — CLI, runners, admission, state store |
  84. | `@ai-sdlc/pipeline-cli` | [`pipeline-cli/`](pipeline-cli/) | Step 0-13 pipeline runtime; `cli-orchestrator`, `cli-deps`, `cli-decisions`, `cli-tui` |
  85. | `ai-sdlc-plugin` | [`ai-sdlc-plugin/`](ai-sdlc-plugin/) | Claude Code plugin — hooks, slash commands, reviewer subagents, MCP server |
  86. | `@ai-sdlc/sdk` | [`sdk-typescript/`](sdk-typescript/) | TypeScript SDK |
  87. | `ai-sdlc-framework` | [`sdk-python/`](sdk-python/) | Python SDK (`pip install ai-sdlc-framework`) |
  88. | `sdk-go` | [`sdk-go/`](sdk-go/) | Go SDK + Kubernetes-style operator CRDs |
  89. | `@ai-sdlc/conformance` | [`conformance/`](conformance/) | Language-agnostic conformance test suite |
  90. | `spec/` | [`spec/`](spec/) | Formal specification, RFCs, JSON schemas |
  91. For development setup (`pnpm install`, build, test, schema validation), see [`docs/getting-started/`](docs/getting-started/) and [`CONTRIBUTING.md`](CONTRIBUTING.md).
  92. ---
  93. ## Specification & versioning
  94. The specification follows Kubernetes-style API maturity: **`v1alpha1`** today; `v1beta1` follows a 9-month deprecation window; `v1` follows a 12-month window. Resource types, policy enforcement levels, autonomy, agents, and adapters all live under [`spec/`](spec/) with JSON Schema (draft 2020-12) under [`spec/schemas/`](spec/schemas/).
  95. Architectural changes go through the [RFC process](spec/rfcs/README.md). The registry there is the canonical lookup for every RFC number — active, reserved, withdrawn, and implemented.
  96. ---
  97. ## Contributing, governance, license
  98. - **Contributing:** [`CONTRIBUTING.md`](CONTRIBUTING.md) — bug reports, feature requests, code, and spec changes (via [RFC](spec/rfcs/README.md))
  99. - **Governance:** [`GOVERNANCE.md`](GOVERNANCE.md) — project roles, decision making, SIG structure
  100. - **Charter:** [`CHARTER.md`](CHARTER.md) — mission, scope, IP policy, CNCF alignment
  101. - **License:** [Apache 2.0](LICENSE) — commercial and open-source use, no restrictions
  102. - **Code of Conduct:** [Contributor Covenant v2.1](CODE_OF_CONDUCT.md)
  103. ---
  104. <div align="center">
  105. **[Website](https://ai-sdlc.io?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=footer-home)** · **[Documentation](https://ai-sdlc.io/docs?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=footer-docs)** · **[Specification](https://ai-sdlc.io/docs/spec/spec?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=footer-docs-spec-spec)** · **[Vision](VISION.md)** · **[Pricing](https://ai-sdlc.io/pricing?utm_source=github&utm_medium=readme&utm_campaign=ai-sdlc-repo&utm_content=footer-pricing)**
  106. If you find this project useful, please consider giving it a star.
  107. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.