@aisdlc/core 1.5.2 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -5071,11 +5071,11 @@ function extractDesignExpectedScope(changeDir) {
5071
5071
  }
5072
5072
  return expected;
5073
5073
  }
5074
- function extractHandoffExpectedScope(changeDir, maxUc, violations) {
5074
+ function extractHandoffExpectedScope(changeDir, maxUc = 1, violations) {
5075
5075
  const handoff = loadProductHandoffSidecar(changeDir);
5076
5076
  if (!handoff?.subgraph) return [];
5077
5077
  const ucList = handoff.subgraph.useCases || [];
5078
- if (maxUc !== void 0 && ucList.length > maxUc && violations) {
5078
+ if (ucList.length > maxUc && violations) {
5079
5079
  violations.push(
5080
5080
  `[${handoff.changeId}] Greenfield monolith detected: change bundles ${ucList.length} use cases (max ${maxUc}). Decompose into incremental SDD changes per Use Case.`
5081
5081
  );
@@ -11605,6 +11605,181 @@ Canonical Reference: [\`process/09_agent_protocols.md\`](../../process/09_agent_
11605
11605
  ${agent.body}
11606
11606
  `;
11607
11607
  }
11608
+ var LIFECYCLE_SKILL_TEMPLATES = [
11609
+ {
11610
+ id: "aisdlc-greenfield",
11611
+ title: "Greenfield Project Inception & Delivery Playbook",
11612
+ description: "Orchestrate end-to-end AI-SDLC onboarding and Phase 0 Inception for brand-new (Greenfield) projects, from repository initialization (aisdlc init) and NAF v4 Vision (ARCH-INTRO-*) through ProductShape, STRIDE Threat Modeling, arc42 Architecture, and initial SDD increment delivery.",
11613
+ references: "[`process/02_product_definition.md`](../../process/02_product_definition.md), [`process/05_architecture_arc42_nafv4.md`](../../process/05_architecture_arc42_nafv4.md), [`process/06_spec_driven_development.md`](../../process/06_spec_driven_development.md), and [`process/09_agent_protocols.md`](../../process/09_agent_protocols.md).",
11614
+ body: `## Purpose & Trigger
11615
+ Use this skill when starting a **brand-new software project from scratch (Greenfield)** or when \`specs/product/\` has no canonical baseline yet. It coordinates the sequential execution of AI-SDLC MCP/CLI tools and specialized role agents so no code is written before product vision, security enclaves, and architecture contracts exist.
11616
+
11617
+ ## End-to-End Execution Playbook
11618
+
11619
+ ### Step 1: Repository Turnkey Initialization
11620
+ 1. If the workspace has not been initialized with AI-SDLC schemas, policies, and templates, run MCP tool \`new\` (or CLI \`npx @aisdlc/cli init\`).
11621
+ 2. Install the Git telemetry hook via \`npx aisdlc git hook install\` (\`pnpm run git:hook:install\`).
11622
+ 3. Verify \`quality-policy.yaml\` and \`license-policy.yaml\` are present in the repository root.
11623
+
11624
+ ### Step 2: Phase 0 Product Inception (\`agent-product-analyst\`)
11625
+ 1. Delegate to or adopt [\`agent-product-analyst\`](../agent-product-analyst/SKILL.md).
11626
+ 2. **Discovery Interview (3\u20135 Questions)**: Before generating artifacts, clarify with the human Product Owner:
11627
+ - Core mission statement and business problem.
11628
+ - Primary actors (\`ACT-*\`) and external systems.
11629
+ - Essential MVP capabilities (\`UC-*\`) vs. future roadmap.
11630
+ - Top 3\u20135 quality goals (\`QR-*\`) and regulatory/technical constraints (\`CON-*\`).
11631
+ 3. **Enterprise & Capability Vision**: Create \`specs/architecture/ARCH-INTRO-001.md\` (\`status: draft\`, \`naf-perspective: "Enterprise & Capability"\`) using \`templates/architecture/introduction-and-goals.template.md\`.
11632
+ 4. **ProductShape Baseline**: Derive initial draft artifacts in \`specs/product/\`:
11633
+ - Actors (\`ACT-*\`), Use Cases (\`UC-*\`), Business Rules (\`BR-*\`), Functional Requirements (\`FR-*\` with mandatory \`@nominal\`, \`@boundary\`, \`@invalid\` Gherkin blocks), and Quality Requirements (\`QR-*\`).
11634
+ 5. Validate schemas and duplicates via MCP tools \`verify_schemas\` and \`verify_duplicates\` (or \`npx aisdlc check --fix\`).
11635
+ 6. **Mandatory Upstream UX & MVP Boundary Gate (\`agent-expert-user\`)**: Invoke [\`agent-expert-user\`](../agent-expert-user/SKILL.md) in **Design Mode** to stress-test the proposed workflows, enforce strict MVP boundaries, and separate core MVP \`UC-*\` from future roadmap backlog (\`templates/product/user-design-feedback.template.md\`).
11636
+
11637
+ ### Step 3: Shift-Left Cybersecurity & Threat Modeling (\`agent-threat-modeler\`)
11638
+ 1. Delegate to or adopt [\`agent-threat-modeler\`](../agent-threat-modeler/SKILL.md).
11639
+ 2. Analyze every \`UC-*\` and \`FR-*\` using STRIDE and OWASP ASVS to create in \`specs/security/\`:
11640
+ - Threat Actors (\`ACT-THREAT-*\`)
11641
+ - Abuse Cases (\`ABUSE-*\` targeting \`UC-*\`)
11642
+ - Security Requirements (\`SEC-REQ-*\` with \`@security @mitigation\` negative Gherkin scenarios and \`SEC-ENC-*\` Zero Trust enclave bindings).
11643
+ 3. Run \`verify_schemas\` (\`npx aisdlc verify schemas --path specs/security\`).
11644
+
11645
+ ### Step 4: Modular Systems Architecture (\`agent-system-architect\`)
11646
+ 1. Delegate to or adopt [\`agent-system-architect\`](../agent-system-architect/SKILL.md).
11647
+ 2. Define building blocks (\`CMP-*\`) and Architectural Decision Records (\`ADR-*\`) in \`specs/architecture/\` using \`templates/architecture/\`, ensuring every \`CMP-*\` cites \`implements-use-cases\` (\`UC-*\`) and \`satisfies-requirements\` (\`FR-*\`, \`QR-*\`, \`SEC-REQ-*\`).
11648
+ 3. Inspect third-party stack choices against \`license-policy.yaml\` via \`verify_licenses\`.
11649
+ 4. **Technical Security Feedback Loop**: If new infrastructure, persistence, or auth decisions introduce attack vectors, return to \`agent-threat-modeler\` to add technical \`SEC-REQ-*\` mitigations before coding.
11650
+
11651
+ ### Step 5: Release Milestone & Topological Wave SDD Plan (\`1 UC-* = 1 CHG-*\`)
11652
+ 1. **Open Release Milestone (\`Tier 2: release/v1.0.0\`)**: Group the approved MVP Use Cases (\`UC-001\`, \`UC-002\`, ...) under the initial release milestone (\`release/v1.0.0\`) and visualize the branch hierarchy via \`npx aisdlc git plan\`.
11653
+ 2. **Decompose into Topological Waves (DAG Parallelism)**:
11654
+ - **Wave 0 \u2014 Foundational Core (Sequential)**: Identify the foundational \`UC-*\` (core domain entities, shared contracts, auth/config) and deliver it first as \`CHG-001\` via [\`aisdlc-increment\`](../aisdlc-increment/SKILL.md) so downstream agents share locked interfaces.
11655
+ - **Waves 1..N \u2014 Orthogonal Capabilities (Parallel Multi-Agent)**: Once Wave 0 contracts are merged into \`release/v1.0.0\`, scaffold independent \`CHG-*\` increments (\`1 UC-* = 1 CHG-*\`) and execute them **in parallel** across isolated branches/worktrees (\`feat/CHG-002\`, \`feat/CHG-003\`, ...) whenever they target distinct components (\`CMP-*\`) or bounded contexts (\`BC-*\`).
11656
+ 3. **Release Consolidation (\`release/v1.0.0\` \u2794 \`main\`)**: Once all MVP \`CHG-*\` increments are integrated (\`sdd_integrate\`), run \`verify\` (\`npx aisdlc verify all\`), generate SBOM (\`npx aisdlc verify licenses --sbom reports/sbom.cdx.json --notices THIRD_PARTY_NOTICES.md\`), compute release KPIs (\`kpi_release\`), and open the Release PR into \`main\` for human Product Owner & Release Manager sign-off.
11657
+
11658
+ ## Non-Negotiable Guardrails
11659
+ - **FORBIDDEN Greenfield Monolith (\`1 UC-* = 1 CHG-*\`)**: Never bundle the entire product or multiple \`UC-*\` into a single SDD change (\`CHG-001\`). Deterministic Gate 3 (\`verify_governance\`) blocks any \`handoff.yaml\` containing $> 1$ Use Case (\`Greenfield monolith detected\`). Parallelism is achieved by running **multiple bounded \`CHG-*\` concurrently** on separate branches/worktrees, never by stuffing multiple \`UC-*\` into one \`CHG-*\`.
11660
+ - Never invoke \`sdd_change_new\` or write application code in \`src/\` on a Greenfield project before \`ARCH-INTRO-001\`, \`agent-expert-user\` MVP validation, and at least one \`UC-*\` and \`FR-*\` exist.
11661
+ - All newly drafted specifications must start with \`status: draft\`.
11662
+ - Respect the Workflow Handoff Protocol (\`templates/workflow/agent-handoff.template.md\`) whenever task autonomy is $\\ge$ \`HUMAN_REVIEW_PLAN\`.`
11663
+ },
11664
+ {
11665
+ id: "aisdlc-legacy-onboarding",
11666
+ title: "Legacy / Brownfield Retro-Inception Playbook",
11667
+ description: "Orchestrate progressive AI-SDLC adoption and Brownfield retro-inception on existing or legacy repositories without breaking production code, reverse-engineering architecture (ARCH-INTRO-*, CMP-*) and establishing baseline quality, security, and license audits before new SDD increments.",
11668
+ references: "[`process/02_product_definition.md`](../../process/02_product_definition.md), [`process/04_open_source_license_compliance.md`](../../process/04_open_source_license_compliance.md), [`process/05_architecture_arc42_nafv4.md`](../../process/05_architecture_arc42_nafv4.md), [`process/10_quality_management_and_release_gates.md`](../../process/10_quality_management_and_release_gates.md), and [`process/09_agent_protocols.md`](../../process/09_agent_protocols.md).",
11669
+ body: `## Purpose & Trigger
11670
+ Use this skill when **adopting AI-SDLC in an existing or legacy codebase (Brownfield)** that already has production source code (\`src/\`, \`packages/\`, etc.) but lacks canonical PDaC specifications, arc42 architecture views, or deterministic quality/license gates.
11671
+
11672
+ ## End-to-End Execution Playbook
11673
+
11674
+ ### Step 1: Non-Destructive Framework Scaffolding
11675
+ 1. Run MCP tool \`new\` (or CLI \`npx @aisdlc/cli init\`) on the existing repository.
11676
+ - AI-SDLC enforces strict **no-clobber protection**: existing \`package.json\`, \`CLAUDE.md\`, or CI pipelines are preserved while injecting missing schemas (\`schemas/\`), templates (\`templates/\`), policies (\`quality-policy.yaml\`, \`license-policy.yaml\`), and MCP configs.
11677
+ 2. Install the Git commit trailer hook via \`npx aisdlc git hook install\`.
11678
+
11679
+ ### Step 2: Baseline Diagnostic Audit (Read-Only Assessment)
11680
+ Before modifying any code or creating SDD changes, run diagnostic verifiers to quantify existing technical, legal, and security debt:
11681
+ 1. **License & Dependency Audit (\`agent-compliance-checker\`)**: Run MCP tool \`verify_licenses\` (\`npx aisdlc verify licenses\`). Identify any viral (\`GPL\`/\`AGPL\`) or commercial (\`BSL\`/\`SSPL\`) dependencies already present in the lockfile and document exceptions or remediation plans.
11682
+ 2. **Shift-Left Security Scan (\`agent-security-auditor\`)**: Run MCP tool \`verify_security\` (\`npx aisdlc verify security\`) to detect hardcoded secrets (Gate 11) or OWASP SAST vulnerabilities in legacy files.
11683
+ 3. **AST Code Quality Baseline (\`agent-code-reviewer\`)**: Run MCP tool \`report_quality\` (\`npx aisdlc report quality\`) to generate \`reports/QUALITY_REPORT.md\` and identify legacy hotspots exceeding Cyclomatic Complexity ($\\le 10$), Cognitive Complexity ($\\le 15$), or Maintainability Index ($\\ge 50$).
11684
+
11685
+ ### Step 3: Brownfield Retro-Inception (\`agent-system-architect\` & \`agent-product-analyst\`)
11686
+ Instead of attempting to document 100% of a legacy monolith upfront, apply **bounded retro-inception** focused on the system boundary and the domain areas under active evolution:
11687
+ 1. **System Vision & Context (\`ARCH-INTRO-001\`)**: Use [\`agent-product-analyst\`](../agent-product-analyst/SKILL.md) to document the current system's mission, primary actors (\`ACT-*\`), and top quality goals (\`QR-*\`) in \`specs/architecture/ARCH-INTRO-001.md\`.
11688
+ 2. **As-Is Component Mapping (\`CMP-*\` & \`ADR-*\`)**: Use [\`agent-system-architect\`](../agent-system-architect/SKILL.md) to map existing core modules/services into \`specs/architecture/CMP-*.md\` and capture historical architectural constraints (\`CON-*\`, \`ADR-*\`).
11689
+ 3. **Core Use Cases Extraction (\`UC-*\`, \`FR-*\`)**: Extract canonical \`UC-*\` and \`FR-*\` artifacts in \`specs/product/\` for the specific bounded context or module that will be modified or extended next, including Gherkin acceptance scenarios reflecting current expected behavior (characterization specs).
11690
+ 4. **Threat & Trust Boundary Mapping (\`agent-threat-modeler\`)**: Map existing trust zones (\`SEC-ENC-*\`) and active threat vectors (\`ACT-THREAT-*\`, \`ABUSE-*\`, \`SEC-REQ-*\`) on the target module.
11691
+
11692
+ ### Step 4: Characterization Testing & Synchronization
11693
+ 1. Run MCP tool \`sdd_check_fix\` (\`npx aisdlc check --fix\`) to extract \`.feature\` files and compute canonical SHA-256 digests.
11694
+ 2. Run \`verify_schemas\` and \`verify_pdac\` to confirm the reverse-engineered baseline graph is structurally valid and drift-free.
11695
+
11696
+ ### Step 5: Transition to Governed SDD Increments (Boy Scout / Strangler Rule)
11697
+ Once the target domain's baseline artifacts (\`ARCH-INTRO-*\`, \`UC-*\`, \`FR-*\`, \`CMP-*\`) are in place, execute all new features, refactorings, or bugfixes via [\`aisdlc-increment\`](../aisdlc-increment/SKILL.md).
11698
+
11699
+ ## Non-Negotiable Guardrails
11700
+ - **Zero Drive-By Rewrites**: Never mass-refactor untouched legacy modules during onboarding. Apply the Strangler / Boy Scout rule: bring touched functions into compliance with \`quality-policy.yaml\` incrementally via governed SDD tasks (\`TSK-*\`).
11701
+ - **Characterization First**: Never alter legacy business logic without first capturing its current behavior in an \`FR-*\` Gherkin specification and a verifiable test suite (\`agent-qa-engineer\`).
11702
+ - **Immediate Secret Remediation**: If Step 2 (\`verify_security\`) uncovers leaked credentials (exit code 4), halt feature work and remediate/rotate secrets immediately.`
11703
+ },
11704
+ {
11705
+ id: "aisdlc-increment",
11706
+ title: "Bounded SDD Feature & Bugfix Delivery Playbook",
11707
+ description: "Orchestrate the complete Spec-Driven Development (SDD) lifecycle for bounded feature increments, enhancements, and bugfixes (CHG-* / TSK-*), from upstream requirement derivation and 4-tier Git branching through Red-Green-Refactor TDD, Pre-Merge Audit Triad, all 11 Quality Gates, and canonical baseline integration.",
11708
+ references: "[`process/06_spec_driven_development.md`](../../process/06_spec_driven_development.md), [`process/08_citation_contract_and_drift.md`](../../process/08_citation_contract_and_drift.md), [`process/10_quality_management_and_release_gates.md`](../../process/10_quality_management_and_release_gates.md), [`process/11_git_branching_and_lifecycle.md`](../../process/11_git_branching_and_lifecycle.md), and [`process/09_agent_protocols.md`](../../process/09_agent_protocols.md).",
11709
+ body: `## Purpose & Trigger
11710
+ Use this skill for **every evolutionary increment (new feature, enhancement, refactoring, or bugfix)** on a project that already has an AI-SDLC baseline. It enforces strict 360\xB0 traceability from upstream ProductShape (\`UC-*\`, \`FR-*\`) through SDD (\`CHG-*\`, \`HOF-*\`, \`TSK-*\`), TDD implementation, the 11 Quality Gates, and baseline promotion.
11711
+
11712
+ ## End-to-End Execution Playbook
11713
+
11714
+ ### Step 1: Upstream Product & Security Delta (\`agent-product-analyst\` & \`agent-threat-modeler\`)
11715
+ 1. Inspect active changes via MCP tool \`get_active_handoff\` and verify whether the target Use Case (\`UC-*\`) or Requirement (\`FR-*\`) already exists in \`specs/product/\`.
11716
+ 2. If the increment introduces new behavior or modifies business rules:
11717
+ - Use [\`agent-product-analyst\`](../agent-product-analyst/SKILL.md) to create or update the \`UC-*\`, \`BR-*\`, and \`FR-*\` (with \`@nominal\`, \`@boundary\`, \`@invalid\` Gherkin scenarios).
11718
+ - Run MCP tool \`verify_duplicates\` (\`npx aisdlc verify duplicates\`) to block lexical or functional collisions early.
11719
+ - Use [\`agent-threat-modeler\`](../agent-threat-modeler/SKILL.md) to model any new \`ABUSE-*\` and \`SEC-REQ-*\` mitigations.
11720
+ 3. Run \`sdd_check_fix\` (\`npx aisdlc check --fix\`) to sync Gherkin \`.feature\` files and validate schemas.
11721
+
11722
+ ### Step 2: SDD Change Scaffolding & Architectural Design (\`agent-system-architect\`)
11723
+ 1. Scaffold the bounded change package and its cryptographic \`handoff.yaml\` sidecar (\`HOF-*\`) targeting **a single Use Case (\`1 UC-* = 1 CHG-*\`)** using MCP tool \`sdd_change_new\` (or CLI \`npx aisdlc change new "<Title>" --from <UC-ID> --profile <patch|standard|critical>\`).
11724
+ 2. Use [\`agent-system-architect\`](../agent-system-architect/SKILL.md) to complete \`specs/changes/active/<chg-id>/design.md\` and \`specs/architecture/CMP-*.md\`:
11725
+ - Define **Contract-First** shared interfaces/DTOs/schemas when spanning Frontend and Backend.
11726
+ - Map 100% of \`handoff.yaml\` requirements and components to atomic tasks (\`TSK-*\`) in \`tasks.md\` with explicit \`autonomy-mode\` (\`AUTONOMOUS\`, \`HUMAN_REVIEW_PLAN\`, \`HIGH_RISK_MANUAL\`, \`AMBIGUOUS\`).
11727
+ 3. Run \`verify_governance\` and \`verify_friction\` to validate task governance, 100% design/handoff scope coverage, and anti-monolith limits (\`maxUseCasesPerChange = 1\`).
11728
+
11729
+ ### Step 3: 4-Tier Git Branch Navigation & Multi-Agent Parallelism
11730
+ 1. Navigate to the task branch using \`npx aisdlc git checkout <TSK-ID>\` (\`pnpm run git:checkout <TSK-ID>\`), which cascade-creates:
11731
+ \`main\` \u2794 \`release/vX.Y.Z\` \u2794 \`feat/CHG-XXX\` \u2794 \`task/CHG-XXX/TSK-YYY-<slug>\`.
11732
+ 2. Validate branch naming compliance via \`npx aisdlc git validate <branch>\`.
11733
+ 3. **Parallel Agent Execution Rules**:
11734
+ - **Inter-Feature Parallelism (\`feat/CHG-001\` $\\parallel$ \`feat/CHG-002\`)**: Multiple agents may execute different \`CHG-*\` increments concurrently in isolated branches/worktrees (\`specs/changes/active/chg-XXX/\`) when their target \`CMP-*\` / \`UC-*\` have no blocking dependencies.
11735
+ - **Intra-Feature Parallelism (\`task/CHG-X/TSK-002\` $\\parallel$ \`task/CHG-X/TSK-003\`)**: Once \`TSK-001\` (Contract-First shared interfaces/DTOs) is merged into \`feat/CHG-X\`, multiple \`agent-developer\` subagents may implement independent tasks (e.g., Backend adapter vs. Frontend UI) concurrently on their respective \`task/*\` branches.
11736
+
11737
+ ### Step 4: Red Phase \u2014 Failing Test Suites (\`agent-qa-engineer\`)
11738
+ 1. Delegate to or adopt [\`agent-qa-engineer\`](../agent-qa-engineer/SKILL.md).
11739
+ 2. Author FAILING (red) BDD/Gherkin step definitions, integration/contract tests, and mandatory E2E/UI tests (evaluating Happy Path, Sad Path, and Boundary Values for every interactive UI element, plus \`UC-*\` alternative/exception flows) in \`tests/\`.
11740
+ 3. Run \`verify_testing\` (\`npx aisdlc verify testing\`) to confirm requirement test coverage before writing production code.
11741
+
11742
+ ### Step 5: Green & Refactor Phase \u2014 Surgical Implementation (\`agent-developer\`)
11743
+ 1. Delegate to or adopt [\`agent-developer\`](../agent-developer/SKILL.md).
11744
+ 2. Execute the **Mandatory 4-Step Implementation Order**:
11745
+ - (1) Clean Architecture boundaries, (2) Inter-module interfaces first, (3) Concrete component implementation (zero fake-wiring; all 4 UI states \`Loading\`, \`Empty\`, \`Error\`, \`Nominal\`), (4) Exhaustive per-function unit tests in \`tests/unit/\` (Happy Path, Sad Path, Boundary, Null/Empty).
11746
+ 3. Verify any new dependency against \`license-policy.yaml\` via \`verify_licenses\`.
11747
+ 4. Run \`sdd_check_fix\` (\`npx aisdlc check --fix\`) and \`verify_quality\` (\`npx aisdlc verify quality\`) until Cyclomatic Complexity $\\le 10$, Cognitive $\\le 15$, Maintainability $\\ge 50$, and Function Length $\\le 40$ lines pass with zero violations.
11748
+
11749
+ ### Step 6: Post-Development Functional Validation & Pre-Merge Audit Triad
11750
+ 1. **Functional Validation (\`agent-expert-user\`)**: Validate live runtime behavior against \`UC-*\` and \`FR-*\` criteria (including \`0\` browser \`console.error\`/\`pageerror\` on UI changes).
11751
+ 2. **Pre-Merge Audit Triad**: Execute concurrent review across:
11752
+ - [\`agent-code-reviewer\`](../agent-code-reviewer/SKILL.md) (SOLID, DRY, YAGNI, AST thresholds, zero fake-wiring)
11753
+ - [\`agent-security-auditor\`](../agent-security-auditor/SKILL.md) (\`verify_security\`: Gitleaks secrets + OWASP SAST)
11754
+ - [\`agent-compliance-checker\`](../agent-compliance-checker/SKILL.md) (\`verify_licenses\`: SPDX & SBOM compliance)
11755
+ 3. **Consolidated Release Gate**: Run MCP tool \`verify\` (\`npx aisdlc verify all\`) and confirm all **11 Quality Gates** pass green.
11756
+
11757
+ ### Step 7: Human PR Sign-Off, Baseline Integration & Release Closure
11758
+ 1. **Feature Merge (\`feat/CHG-*\` \u2794 \`release/vX.Y.Z\`)**: Present the PR, KPI summary (\`kpi_pr\`), and autogenerated reports (\`reports/QUALITY_REPORT.md\`, \`reports/TRACEABILITY_MATRIX.md\`) to the human Tech Lead for review and approval (never auto-approve or auto-merge).
11759
+ 2. **Canonical Baseline Promotion**: Once tasks in \`tasks.md\` are marked \`COMPLETED\` and approved, promote the change into the canonical baseline via MCP tool \`sdd_integrate\` (\`npx aisdlc sdd integrate --auto\`), which promotes \`FR-*\` to \`active\`, links \`CMP-*\`, and archives the change under \`specs/changes/completed/\`.
11760
+ 3. **Release Milestone Closure (\`release/vX.Y.Z\` \u2794 \`main\`)**: When all \`CHG-*\` increments planned for \`release/vX.Y.Z\` are integrated:
11761
+ - Run full verification (\`verify\`), generate CycloneDX SBOM & legal notices (\`npx aisdlc verify licenses --sbom reports/sbom.cdx.json --notices THIRD_PARTY_NOTICES.md\`), compute release telemetry (\`kpi_release\` / \`npx aisdlc kpi release --release release/vX.Y.Z\`), and refresh the interactive dashboard (\`report_dashboard\`).
11762
+ - Open the Release PR from \`release/vX.Y.Z\` to \`main\` for final human Product Owner and Release Manager approval and semantic Git tagging (\`vX.Y.Z\`).
11763
+
11764
+ ## Non-Negotiable Guardrails
11765
+ - **Single-Use-Case Scope (\`1 UC-* = 1 CHG-*\`)**: Each SDD change (\`CHG-*\`) must deliver at most 1 Use Case (\`UC-*\`). Bundling multiple \`UC-*\` into one \`handoff.yaml\` is blocked by \`verify_governance\` (\`Greenfield monolith detected\`). Scale throughput via parallel \`CHG-*\` branches/worktrees, not monolithic changes.
11766
+ - **100% Design & Handoff Coverage in \`tasks.md\`**: Every \`CMP-*\`, \`FR-*\`, and \`SEC-REQ-*\` declared in \`design.md\` and \`handoff.yaml\` must be explicitly assigned to at least one \`TSK-*\` in \`tasks.md\`.`
11767
+ }
11768
+ ];
11769
+ function renderAntigravitySkillFile(skill) {
11770
+ return `---
11771
+ name: ${skill.id}
11772
+ description: >-
11773
+ ${skill.description}
11774
+ ---
11775
+
11776
+ # ${skill.id} (${skill.title})
11777
+
11778
+ Canonical Reference: ${skill.references}
11779
+
11780
+ ${skill.body}
11781
+ `;
11782
+ }
11608
11783
  var STARTER_ANTIGRAVITY_RULES = `# Google Antigravity & Gemini CLI Rules - AI-SDLC Framework
11609
11784
 
11610
11785
  Canonical Reference: [\`process/09_agent_protocols.md\`](../../process/09_agent_protocols.md) and [\`process/01_governance_and_roles.md\`](../../process/01_governance_and_roles.md).
@@ -13843,6 +14018,10 @@ function appendAntigravityFiles(dirs, files) {
13843
14018
  { relPath: `.agent/skills/${agent.id}/SKILL.md`, content }
13844
14019
  );
13845
14020
  }
14021
+ for (const skill of LIFECYCLE_SKILL_TEMPLATES) {
14022
+ dirs.push(`.agent/skills/${skill.id}`);
14023
+ files.push({ relPath: `.agent/skills/${skill.id}/SKILL.md`, content: renderAntigravitySkillFile(skill) });
14024
+ }
13846
14025
  }
13847
14026
  function appendCursorFiles(dirs, files) {
13848
14027
  dirs.push(".cursor/rules");
@@ -14123,6 +14302,7 @@ exports.DEFAULT_SAST_EXCLUDES = DEFAULT_SAST_EXCLUDES;
14123
14302
  exports.GENERAL_SOURCE_EXTENSIONS = GENERAL_SOURCE_EXTENSIONS;
14124
14303
  exports.KPI_SUMMARY_END_TAG = KPI_SUMMARY_END_TAG;
14125
14304
  exports.KPI_SUMMARY_START_TAG = KPI_SUMMARY_START_TAG;
14305
+ exports.LIFECYCLE_SKILL_TEMPLATES = LIFECYCLE_SKILL_TEMPLATES;
14126
14306
  exports.OpenSpecAdapter = OpenSpecAdapter;
14127
14307
  exports.PREPARE_COMMIT_MSG_SCRIPT = PREPARE_COMMIT_MSG_SCRIPT;
14128
14308
  exports.PROMPT_INJECTION_SIGNATURES = PROMPT_INJECTION_SIGNATURES;
@@ -14335,6 +14515,7 @@ exports.processPackageDir = processPackageDir;
14335
14515
  exports.readCodeCoverageSummary = readCodeCoverageSummary;
14336
14516
  exports.readPackageJson = readPackageJson;
14337
14517
  exports.renderAntigravityAgentFile = renderAntigravityAgentFile;
14518
+ exports.renderAntigravitySkillFile = renderAntigravitySkillFile;
14338
14519
  exports.renderAutonomyModeSection = renderAutonomyModeSection;
14339
14520
  exports.renderClaudeAgentFile = renderClaudeAgentFile;
14340
14521
  exports.renderCopilotAgentFile = renderCopilotAgentFile;