@aisdlc/core 3.0.0 → 3.1.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.d.cts CHANGED
@@ -2339,6 +2339,8 @@ interface SpecializedAgentTemplate {
2339
2339
  title: string;
2340
2340
  description: string;
2341
2341
  globs: string;
2342
+ claudeTools?: readonly string[];
2343
+ antigravityTools?: readonly string[];
2342
2344
  body: string;
2343
2345
  }
2344
2346
  declare const SPECIALIZED_AGENT_TEMPLATES: readonly SpecializedAgentTemplate[];
@@ -2365,9 +2367,9 @@ declare const STARTER_CURSOR_PRODUCT_RULES = "---\ndescription: Directives for S
2365
2367
  declare const STARTER_CURSOR_QUALITY_RULES = "---\ndescription: Directives for code quality, architecture, TDD, and complexity limits\nglobs: packages/**, src/**, scripts/**, tests/**\nalwaysApply: false\n---\n\n# Code Quality and Architecture Directives\n\nCanonical Reference: [`process/09_agent_protocols.md`](process/09_agent_protocols.md) and [`process/10_quality_management_and_release_gates.md`](process/10_quality_management_and_release_gates.md).\n\n## 1. Non-Negotiable Quality Thresholds (`quality-policy.yaml`)\n- **Cyclomatic Complexity (CC)**: $\\le 10$ per function (warning alert if $> 7$).\n- **Cognitive Complexity**: $\\le 15$ per function (warning if $> 10$).\n- **Maintainability Index (MI)**: $\\ge 50$ (target minimum $\\ge 65$).\n- **Function Length**: $\\le 40$ lines (warning if $> 30$).\n- If a function exceeds these limits, decompose logic into cohesive helper functions before completing the task.\n\n## 2. TDD Methodology, Modular & Hexagonal Architecture (Ports & Adapters) & Unit Testing\n- **Mandatory 4-Step Implementation Order**: (1) Define/refine Modular & Hexagonal Architecture (Ports & Adapters) module boundaries, (2) Define interfaces/ports for all inter-module interactions to avoid direct module coupling, (3) Implement components consuming/fulfilling those interfaces, (4) Write unit tests for every function covering Happy Path, Sad Path, Boundary Values, and Unexpected/Null/Empty values.\n- Apply Test-Driven Development: generate unit tests before or alongside component logic.\n- Tag tests linked to requirements with header comments citing the ID (`FR-*`, `SEC-REQ-*`, or `PRIV-REQ-*`) to enable reverse traceability.\n- Suppressing types (`any`), linter rules (`eslint-disable`), or unit tests to force pipeline passage is prohibited.\n- **Mandatory Regression Verification**: Never declare build, typecheck, or bug fixes complete without executing the relevant automated test suite (`pnpm test`, `dotnet test`) and confirming zero regressions.\n- **Global Styles Protection**: When touching or refactoring frontend views, verify that global stylesheet/asset imports remain intact and that layouts suffer no visual disruption.\n\n## 3. Open Source License Policy (`license-policy.yaml`)\n- Before adding any dependency to `package.json`, verify its SPDX identifier.\n- Only permissive dependencies are allowed (`MIT`, `Apache-2.0`, `BSD-2/3-Clause`, `ISC`).\n- Viral licenses (`GPL`, `AGPL`) or commercial licenses without approval (`BSL`, `SSPL`) are prohibited.\n\n## 4. Structured Output `--json`\n- Any extension to CLI commands must preserve compatibility with the `--json` flag and suppress ANSI escape codes when this flag is present.\n";
2366
2368
  declare const STARTER_CLAUDE_RULES = "# Claude Code Instructions - AI-SDLC Monorepo\n\nCanonical Reference: [`process/09_agent_protocols.md`](process/09_agent_protocols.md) and [`process/01_governance_and_roles.md`](process/01_governance_and_roles.md).\n\nThis repository implements the **AI-SDLC** framework (Spec-Driven Development, deterministic quality governance, Privacy-by-Design, and OSS license compliance for human-agent collaboration).\n\n---\n\n## 1. The 5 Unbreakable Commandments of Agents | Los 5 Mandamientos Inquebrantables de los Agentes\n\n1. **FORBIDDEN TO AUTO-APPROVE OR AUTO-MERGE | PROHIBIDO AUTO-APROBAR O AUTO-FUSIONAR**: Never approve PRs or merge directly to `main` or protected branches. Approval is exclusively a human prerogative.\n2. **FORBIDDEN TO INVENT PRODUCT OR ARCHITECTURE DECISIONS**: When facing ambiguous requirements, formulate open questions (`open-questions`). Never assume undocumented behaviors.\n3. **FORBIDDEN TO INTRODUCE DEPENDENCIES WITHOUT LICENSE INSPECTION**: Always validate the SPDX identifier against `license-policy.yaml`. Viral libraries (`GPL`/`AGPL`) or paid commercial libraries (`BSL`/`SSPL`) are strictly forbidden without formal human approval.\n4. **FORBIDDEN TO IGNORE CYBERSECURITY & PRIVACY (SECURITY-BY-DEFAULT & PRIVACY-BY-DEFAULT)**: Validate inputs, sanitize data, protect PII according to `privacy-policy.yaml`, and include mitigation tests (`SEC-TEST-*`, `@privacy`). Disabling linters or suppressing typing errors (`any`, `@ts-ignore`) is prohibited.\n5. **MANDATORY CRYPTOGRAPHIC CITATION**: Every spec or sidecar must cite immutable identifiers and Unix LF-normalized SHA-256 digests.\n\n---\n\n## 2. Essential Execution and Pre-Flight Commands\n\n```bash\n# 1. Pre-flight with deterministic auto-fix (Gherkin & SHA-256 digests)\npnpm run check:fix\n\n# 2. Complete verification across all Quality Gates (Quality, RTM, Governance, Testing, Licenses, PDaC, Schemas, Duplicates, Security, Privacy)\npnpm run verify:all\n\n# 3. Complete automated test suite (Vitest)\npnpm test\n\n# 4. Strict TypeScript typechecking\npnpm run typecheck\n\n# 5. Scaffolding for a new SDD change\npnpm run change:new <name> --id <chg-id>\n\n# 6. Canonical integration of a completed SDD change\nnpx tsx packages/cli/src/index.ts sdd integrate --change <chg-id>\n```\n\n---\n\n## 3. Specialized Roles Mapping\n\n### 1. `agent-product-analyst` (Product Analyst / Scribe)\n- **Mission**: Capture new product intent via NAF v4 Enterprise & Capability Vision (`ARCH-INTRO-*`) and define/refine the product model using ProductShape.\n- **Phase 0 (Greenfield Product Inception)**: When creating a new product from scratch (or when `specs/product/` has no baseline), run a concise 3\u20135 question discovery interview (mission/problem, actors `ACT-*`, MVP capabilities `UC-*`, priority quality goals `QR-*`), draft `ARCH-INTRO-001` (`templates/architecture/introduction-and-goals.template.md`), and derive initial `ACT-*`, `UC-*`, `BR-*`, `FR-*`, and `QR-*` drafts.\n- **Input**: Business intent or natural language specification.\n- **Output**: Markdown artifacts with YAML frontmatter compliant with `schemas/architecture/introduction-and-goals.schema.json` (`ARCH-INTRO-*`) and `schemas/product/` (`ACT-*`, `UC-*`, `FR-*`, `QR-*`, `BR-*`).\n- **Guardrails**: `status` always starts in `draft`. Mandatory Gherkin criteria with `@<ID> @automated @regression`.\n\n### 2. `agent-threat-modeler` (Threat Modeler and Security Specialist)\n- **Mission**: Analyze use cases and proactively model adversaries, STRIDE attack vectors, and OWASP ASVS mitigations, both at product level and in the technical security feedback loop over architecture, handing off to `agent-privacy-officer`.\n- **Output**: Cybersecurity triad (`ACT-THREAT-*`, `ABUSE-*`, `SEC-REQ-*`) compliant with `schemas/security/`.\n\n### 3. `agent-privacy-officer` (Data Protection & Privacy-by-Design Specialist)\n- **Mission**: Receive handoff from `agent-threat-modeler` to model personal data assets (`DATA-ASSET-*`), GDPR Art. 30 records of processing (`PRIV-ROPA-*`), and LINDDUN / GDPR / ISO 27701 privacy requirements (`PRIV-REQ-*`), and audit code diffs against `privacy-policy.yaml`.\n- **Directives**: Run `pnpm run verify:privacy`, enforce PII masking in logs/LLM prompts, and trigger `DPIA-*` requests on Art. 9 sensitive data.\n\n### 4. `agent-system-architect` (System Architect)\n- **Mission**: Translate the approved product definition into a modular technical architecture based on arc42 enriched with NAF v4 (`CMP-*`, Mermaid diagrams, `ADR-*`).\n- **Guardrails**: Declare `satisfies-requirements` on every `CMP-*` (including `PRIV-REQ-*`), structure components following **Modular & Hexagonal Architecture (Ports & Adapters)** (Domain/Application Core + Inbound/Outbound Ports), instantiate mandatory building block `CMP-OBSERVABILITY` (Level 2/3) alongside Section 8 and an ADR for runtime telemetry, and trigger the technical security/privacy feedback loop toward `agent-threat-modeler` \u2794 `agent-privacy-officer` when infrastructure decisions introduce new attack vectors or PII flows.\n\n### 5. `agent-qa-engineer` (QA Engineer and SDET)\n- **Mission**: Translate approved requirements (`FR-*`, `SEC-REQ-*`, `PRIV-REQ-*`, `QR-*`) into comprehensive FAILING (red) BDD/Gherkin, End-to-End (E2E), UI, and unit test suites, before `agent-developer` writes production code.\n- **Guardrails**: Always use the agreed project technology/testing stack (if any). Never omit End-to-End (E2E) and UI tests. Create specific tests for every interactive UI element using external tools such as Playwright or FlatUI (or the agreed project testing technology), covering Happy Path, Sad Path, and Boundary Values. FORBIDDEN to include production code. Mandatory tags: `@<FR-ID> @automated @regression`.\n\n### 6. `agent-developer` (Software Developer)\n- **Mission**: Implement atomic tasks from SDD specifications (`tasks.md`) with clean, strictly typed code and thorough tests.\n- **Directives**: Execute the mandatory 4-step order: (1) Modular & Hexagonal Architecture (Ports & Adapters) definition/redefinition, (2) Inter-module interfaces first, (3) Component implementation, (4) Per-function unit tests (Happy Path, Sad Path, Boundary Values, Unexpected/Null/Empty values). Respect the autonomy mode. Make tests delivered by `agent-qa-engineer` pass green. Run `pnpm run check:fix` and `pnpm run verify:all`. Enforce Mandatory Regression Verification (`pnpm test`) with zero regressions before declaring completion, and enforce Global Styles Protection on frontend views.\n\n### 7. `agent-security-auditor` (Adversarial Code Auditor)\n- **Mission**: Examine Pull Requests for business logic vulnerabilities, injection vectors, secret leaks, and authorization flaws as part of the Pre-Merge Audit Triad.\n- **Directives**: Run `pnpm run verify:security`, evaluate CVSS v3.1 severity, and block CRITICAL/HIGH risks.\n\n### 8. `agent-compliance-checker` (Open Source License Compliance Auditor)\n- **Mission**: Audit dependency manifests against `license-policy.yaml` as part of the Pre-Merge Audit Triad.\n- **Directives**: Run `pnpm run verify:licenses`, blocking viral (`GPL`, `AGPL`) or unapproved commercial (`BSL`, `SSPL`) packages.\n\n### 9. `agent-expert-user` (Expert User and Domain Evaluator)\n- **Mission**: Contrast design and specifications (design phase) and functionally validate finished software against `UC-*` and `FR-*` (post-development functional validation phase).\n\n### 10. `agent-code-reviewer` (Technical and Architectural Code Reviewer)\n- **Mission**: Audit Pull Requests evaluating code cleanliness, adherence to SOLID, DRY, YAGNI principles, and respect for `quality-policy.yaml` thresholds, forming part of the Pre-Merge Audit Triad.\n- **Findings classification**: `[BLOCKING]`, `[CLEAN_CODE_SUGGESTION]`, `[COMPLIANT]`.\n\n### 11. `agent-devops` (Automation and Infrastructure Engineer)\n- **Mission**: Maintain, evolve, and audit automated project infrastructure: CI/CD workflows, Docker containers, IaC manifests, and support scripts.\n- **NON-INVASION GUARDRAIL**: STRICTLY FORBIDDEN from modifying application source code (`src/`, `packages/*/src/`).\n\n---\n\n## 4. Task Autonomy Modes (`tasks.md`)\n\n- \uD83D\uDFE2 **`AUTONOMOUS`**: Low risk, isolated task. Implement code and tests directly. Omit interactive handoff block.\n- \uD83D\uDFE1 **`HUMAN_REVIEW_PLAN`**: Medium risk. Design detailed plan, emit Workflow Handoff block, and wait for human confirmation before coding.\n- \uD83D\uDFE0 **`AMBIGUOUS`**: Incomplete requirements. Blocked: request human clarification.\n- \uD83D\uDD34 **`HIGH_RISK_MANUAL`**: Critical risk (migrations, cryptography). Direct manual execution by humans only.\n\n---\n\n## 5. Git Workflow and Commit Rules with Trailers\n\n### 4-Tier Hierarchy\n1. **Tier 1 (`main`)**: Absolute stability and production readiness.\n2. **Tier 2 (`release/vX.Y.Z`)**: Release stabilization.\n3. **Tier 3 (`feat/<FEAT-ID>-<slug>` or `bug/<BUG-ID>-<slug>`)**: SDD delivery increment.\n4. **Tier 4 (`task/<PARENT-ID>/<TSK-ID>-<slug>`)**: Atomic implementation task.\n\n### Commit Format (Conventional Commits + Git Trailers)\n```text\nfeat(scope): concise imperative description (#issue)\n\nBody explaining the motivation and technical justification of the change.\n\nAuthor-Type: agent\nAI-Model: claude-3-7-sonnet\nTask-ID: TSK-001\nChange-ID: CHG-026-AGENT-NATIVE-CONFIGS\n```\n\n---\n\n## 6. Non-Negotiable Quality Thresholds (`quality-policy.yaml`)\n- **Cyclomatic Complexity (CC)**: $\\le 10$\n- **Cognitive Complexity**: $\\le 15$\n- **Maintainability Index (MI)**: $\\ge 50$\n- **Lines per Function**: $\\le 40$\n- Deterministic CLI output: every `verify` command supports `--json` without ANSI escape codes.\n\n---\n\n## 7. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\u00F3n Humana\n- **Conditional Activation**:\n - \uD83D\uDFE2 **`AUTONOMOUS`** (or PR/CI final supervision): **OMITTED**. Uninterrupted continuous execution.\n - \uD83D\uDFE1 **Autonomy $\\ge$ `HUMAN_REVIEW_PLAN`** (`HUMAN_REVIEW_PLAN`, `AMBIGUOUS`, `HIGH_RISK_MANUAL`): **MANDATORY**. Emit Workflow Handoff block ([`templates/workflow/agent-handoff.template.md`](templates/workflow/agent-handoff.template.md)) and **STOP**.\n- **Content**: Completed deliverables, suggested next role(s), copy-paste ready invocation prompt, and **an open Human Action Window for the user to take action** (review, edit by hand, pause/reroute, or delegate).\n";
2367
2369
  declare const STARTER_COPILOT_RULES = "<!--\n AI-SDLC: Canonical Instructions for GitHub Copilot (Chat & Workspace)\n Canonical Reference: process/09_agent_protocols.md and process/01_governance_and_roles.md\n-->\n\n# GitHub Copilot Instructions - AI-SDLC Framework\n\nYou operate as an assistant agent in the **AI-SDLC** repository. You are not a simple text auto-completer: you are a specialized technical worker subject to normative directives, deterministic autonomy boundaries, and strict traceability.\n\n---\n\n## 1. The 5 Unbreakable Commandments of Agents | Los 5 Mandamientos Inquebrantables de los Agentes\n\n1. **FORBIDDEN TO AUTO-APPROVE OR AUTO-MERGE | PROHIBIDO AUTO-APROBAR O AUTO-FUSIONAR**:\n - Never execute PR approvals or direct merges to stable branches (`main`, `release/*`). Approval is an exclusive human prerogative.\n2. **FORBIDDEN TO INVENT PRODUCT OR ARCHITECTURE DECISIONS**:\n - If a requirement is ambiguous or incomplete, formulate open questions (`open-questions`) to the human user. Guessing undocumented intentions is forbidden.\n3. **FORBIDDEN TO INTRODUCE DEPENDENCIES WITHOUT LICENSE INSPECTION**:\n - Before suggesting or adding dependencies to manifests (`package.json`, etc.), validate their SPDX identifier against `license-policy.yaml`. Adding viral (`GPL`, `AGPL`) or commercial paid (`BSL`, `SSPL`) licenses without human authorization is prohibited.\n4. **FORBIDDEN TO IGNORE CYBERSECURITY & PRIVACY (SECURITY-BY-DEFAULT & PRIVACY-BY-DEFAULT)**:\n - All code must enforce least privilege, sanitize external inputs, protect PII according to `privacy-policy.yaml`, and include mitigation tests (`SEC-TEST-*`, `@privacy`). Suppressing types (`any`), linters, or tests to force a green pipeline is prohibited.\n5. **MANDATORY CRYPTOGRAPHIC CITATION**:\n - Every specification, design, or sidecar must reference canonical identifiers and their Unix LF-normalized SHA-256 digests.\n\n---\n\n## 2. Git 4-Tier Branch Hierarchy\n\nWhen proposing or creating branches, respect the strict hierarchical structure:\n- **Tier 1**: `main` (Protected production branch with maximum stability).\n- **Tier 2**: `release/vX.Y.Z` (Release consolidation and scope freeze branch).\n- **Tier 3**: `feat/<FEAT-ID>-<slug>` or `bug/<BUG-ID>-<slug>` (SDD increment or feature branch).\n- **Tier 4**: `task/<PARENT-ID>/<TSK-ID>-<slug>` (Atomic development task branch).\n\n---\n\n## 3. Pre-Flight Commands and Quality Gates\n\nBefore concluding any intervention or suggesting a commit:\n- **Unified pre-flight with auto-fix**: `pnpm run check:fix` (or `npx aisdlc check --fix`).\n- **Complete Quality Gates verification**: `pnpm run verify:all` (or `npx aisdlc verify all`).\n- **Unit test suite**: `pnpm test`.\n- **Strict typing**: `pnpm run typecheck`.\n\nNon-Negotiable Quality Thresholds (`quality-policy.yaml`):\n- Cyclomatic Complexity (CC) $\\le 10$.\n- Cognitive Complexity $\\le 15$.\n- Maintainability Index (MI) $\\ge 50$.\n- Maximum lines per function $\\le 40$.\n\n---\n\n## 4. Task Autonomy Modes (`tasks.md`)\n\n- \uD83D\uDFE2 **`AUTONOMOUS`**: Low risk, isolated task. Implement code and tests directly. Omit interactive handoff block.\n- \uD83D\uDFE1 **`HUMAN_REVIEW_PLAN`**: Medium risk. Design detailed plan, emit Workflow Handoff block, and wait for human confirmation before coding.\n- \uD83D\uDFE0 **`AMBIGUOUS`**: Incomplete requirements. Blocked: request human clarification.\n- \uD83D\uDD34 **`HIGH_RISK_MANUAL`**: Critical risk (migrations, cryptography). Direct manual execution by humans only.\n\n---\n\n## 5. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\u00F3n Humana\n- **Conditional Activation**:\n * \uD83D\uDFE2 **`AUTONOMOUS` Mode** (or PR/CI final supervision): **OMITTED**. Do not interrupt unattended execution.\n * \uD83D\uDFE1 **Autonomy $\\ge$ `HUMAN_REVIEW_PLAN`** (`HUMAN_REVIEW_PLAN`, `AMBIGUOUS`, `HIGH_RISK_MANUAL`): **MANDATORY**. Emit Workflow Handoff block compliant with [`templates/workflow/agent-handoff.template.md`](../templates/workflow/agent-handoff.template.md) and **STOP**.\n- **Components**: Declare completed deliverables, recommend next roles (`agent-threat-modeler`, `agent-privacy-officer`, `agent-system-architect`, `agent-developer`, `agent-security-auditor`), provide suggested invocation prompt, and **keep the Human Action Window open at all times for the user to take action** (review, edit by hand, pause/reroute, or delegate).\n\n---\n\n## 6. Specialized Roles Mapping\n\n| Role | Mission (summary) |\n| :--- | :--- |\n| `agent-product-analyst` | Phase 0 NAF v4 Enterprise & Capability Vision (`ARCH-INTRO-*`, 3\u20135 question interview) + ProductShape artifacts (`ACT-*`, `UC-*`, `FR-*`, `QR-*`, `BR-*`); `status` starts `draft`. |\n| `agent-threat-modeler` | STRIDE/OWASP threat triad (`ACT-THREAT-*`, `ABUSE-*`, `SEC-REQ-*`); hands off to `agent-privacy-officer`. |\n| `agent-privacy-officer` | LINDDUN & GDPR/LOPDGDD privacy triad (`DATA-ASSET-*`, `PRIV-ROPA-*`, `PRIV-REQ-*`) + Pre-Merge `verify:privacy`. |\n| `agent-system-architect` | Modular arc42 + NAF v4 architecture (`CMP-*`, Mermaid diagrams, `ADR-*`). |\n| `agent-qa-engineer` | FAILING BDD/Gherkin, E2E, and UI suites (using agreed project tech; Happy Path, Sad Path & Boundary Values per interactive UI element) before `agent-developer` writes production code. |\n| `agent-developer` | Atomic tasks from `tasks.md`; autonomy mode must be respected; runs `pnpm run check:fix` + `pnpm run verify:all`. |\n| `agent-security-auditor` | Adversarial PR security audit, SAST, secrets, and CVSS v3.1 evaluation. |\n| `agent-compliance-checker` | SPDX license compliance audit against `license-policy.yaml`. |\n| `agent-expert-user` | Bimodal MVP evaluation (design) and functional validation against `UC-*` and `FR-*` (pre-PR). |\n| `agent-code-reviewer` | PR audit (SOLID, DRY, YAGNI): `[BLOCKING]` / `[CLEAN_CODE_SUGGESTION]` / `[COMPLIANT]`. |\n| `agent-devops` | CI/CD, Docker, IaC only \u2014 **FORBIDDEN** to touch `src/` or `packages/*/src/`. |\n\n---\n\n## 7. Canonical Reference\nTo consult full protocols, specialized prompts, and interface contracts:\n- [`process/09_agent_protocols.md`](../process/09_agent_protocols.md)\n- [`process/01_governance_and_roles.md`](../process/01_governance_and_roles.md)\n";
2368
- declare const STARTER_CURSOR_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ]\n }\n }\n}\n";
2369
- declare const STARTER_ANTIGRAVITY_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ]\n }\n }\n}\n";
2370
- declare const STARTER_VSCODE_MCP = "{\n \"servers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ]\n }\n }\n}\n";
2370
+ declare const STARTER_CURSOR_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ],\n \"env\": {\n \"AISDLC_MCP_ROLE\": \"developer\"\n }\n }\n }\n}\n";
2371
+ declare const STARTER_ANTIGRAVITY_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ],\n \"env\": {\n \"AISDLC_MCP_ROLE\": \"developer\"\n }\n }\n }\n}\n";
2372
+ declare const STARTER_VSCODE_MCP = "{\n \"servers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ],\n \"env\": {\n \"AISDLC_MCP_ROLE\": \"developer\"\n }\n }\n }\n}\n";
2371
2373
 
2372
2374
  /**
2373
2375
  * AI-SDLC: Core Project Initialization and Governance Setup
@@ -2376,7 +2378,7 @@ declare const STARTER_VSCODE_MCP = "{\n \"servers\": {\n \"ai-sdlc\": {\n
2376
2378
  declare const VALID_CI_PROVIDERS: readonly ["github", "gitlab", "azure", "bitbucket"];
2377
2379
  type SupportedCiProvider = (typeof VALID_CI_PROVIDERS)[number];
2378
2380
  declare const STARTER_QUALITY_POLICY = "# ==============================================================================\n# AI-SDLC: Software Quality, Coding Rules & Release Gate Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nenforcement_mode: \"STRICT\"\n\nscope:\n target_directories:\n - \"src\"\n - \"lib\"\n supported_extensions:\n - \".ts\"\n - \".js\"\n - \".py\"\n - \".java\"\n - \".go\"\n - \".cs\"\n - \".rs\"\n - \".cpp\"\n - \".c\"\n exclude_patterns:\n - \"node_modules\"\n - \"__pycache__\"\n - \".pytest_cache\"\n - \"target\"\n - \"bin\"\n - \"obj\"\n - \".git\"\n - \"reports\"\n - \"dist\"\n - \".changeset\"\n - \"examples\"\n - \"scratch\"\n - \"templates\"\n\nthresholds:\n cyclomatic_complexity:\n max_per_function: 10\n cognitive_complexity:\n max_per_function: 15\n maintainability_index:\n min_acceptable_score: 50.0\n function_length:\n max_function_lines: 40\n";
2379
- declare const STARTER_LICENSE_POLICY = "# ==============================================================================\n# AI-SDLC: Open Source License Compliance & Governance Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\ndefault_action: \"DENY\"\n\ncategories:\n permissive_free:\n action: \"ALLOW\"\n description: \"Permissive commercial use licenses. Attribution only required.\"\n spdx_identifiers:\n - \"MIT\"\n - \"Apache-2.0\"\n - \"BSD-2-Clause\"\n - \"BSD-3-Clause\"\n - \"ISC\"\n - \"Unlicense\"\n - \"CC0-1.0\"\n - \"0BSD\"\n\n weak_copyleft_conditional:\n action: \"REVIEW_REQUIRED\"\n description: \"Allowed only as dynamically linked decoupled libraries.\"\n spdx_identifiers:\n - \"LGPL-2.1-only\"\n - \"LGPL-3.0-only\"\n - \"MPL-2.0\"\n\n strong_copyleft_viral:\n action: \"DENY\"\n description: \"Forbidden due to viral copyleft forcing source code disclosure.\"\n spdx_identifiers:\n - \"GPL-2.0-only\"\n - \"GPL-3.0-only\"\n - \"AGPL-3.0-only\"\n - \"AGPL-3.0-or-later\"\n\n commercial_acquisition_required:\n action: \"COMMERCIAL_APPROVAL_REQUIRED\"\n description: \"Source-available code requiring commercial license for SaaS deployment.\"\n spdx_identifiers:\n - \"SSPL-1.0\"\n - \"BSL-1.1\"\n";
2381
+ declare const STARTER_LICENSE_POLICY = "# ==============================================================================\n# AI-SDLC: Open Source License Compliance & Governance Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\ndefault_action: \"DENY\"\n\ncategories:\n permissive_free:\n action: \"ALLOW\"\n description: \"Permissive commercial use licenses. Attribution only required.\"\n spdx_identifiers:\n - \"MIT\"\n - \"Apache-2.0\"\n - \"BSD-2-Clause\"\n - \"BSD-3-Clause\"\n - \"ISC\"\n - \"Unlicense\"\n - \"CC0-1.0\"\n - \"0BSD\"\n - \"Python-2.0\"\n - \"BlueOak-1.0.0\"\n - \"Zlib\"\n - \"CC-BY-3.0\"\n - \"CC-BY-4.0\"\n - \"MS-PL\"\n\n weak_copyleft_conditional:\n action: \"REVIEW_REQUIRED\"\n description: \"Allowed only as dynamically linked decoupled libraries.\"\n spdx_identifiers:\n - \"LGPL-2.1-only\"\n - \"LGPL-2.1-or-later\"\n - \"LGPL-3.0-only\"\n - \"LGPL-3.0-or-later\"\n - \"MPL-2.0\"\n - \"EPL-2.0\"\n - \"CDDL-1.0\"\n - \"MS-RL\"\n - \"MS-LPL\"\n - \"MS-LRL\"\n\n strong_copyleft_viral:\n action: \"DENY\"\n description: \"Forbidden due to viral copyleft forcing source code disclosure.\"\n spdx_identifiers:\n - \"GPL-2.0-only\"\n - \"GPL-3.0-only\"\n - \"AGPL-3.0-only\"\n - \"AGPL-3.0-or-later\"\n\n commercial_acquisition_required:\n action: \"COMMERCIAL_APPROVAL_REQUIRED\"\n description: \"Source-available code requiring commercial license for SaaS deployment.\"\n spdx_identifiers:\n - \"SSPL-1.0\"\n - \"BSL-1.1\"\n";
2380
2382
  declare const STARTER_PRIVACY_POLICY = "# ==============================================================================\n# AI-SDLC: Data Protection & Privacy-by-Design Governance Policy (PDaC)\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nregulatory_frameworks:\n - \"GDPR\"\n - \"LOPDGDD\"\n - \"ISO-27701\"\ndefault_pii_action: \"DENY_UNCLASSIFIED\"\n\nclassification_levels:\n PUBLIC:\n encryption_at_rest: false\n encryption_in_transit: true\n allow_in_logs: true\n allow_in_llm_prompts: true\n INTERNAL:\n encryption_at_rest: true\n encryption_in_transit: true\n allow_in_logs: true\n allow_in_llm_prompts: true\n CONFIDENTIAL_PII:\n encryption_at_rest: true\n encryption_in_transit: true\n allow_in_logs: false\n masking_in_logs: \"HASH_OR_REDACT\"\n allow_in_llm_prompts: false\n require_retention_policy: true\n require_erasure_mechanism: true\n RESTRICTED_SENSITIVE_PII:\n encryption_at_rest: true\n field_level_encryption: true\n encryption_in_transit: true\n allow_in_logs: false\n allow_in_llm_prompts: false\n require_dpia_approval: true\n require_explicit_consent_or_art9_basis: true\n\ncross_border_transfers:\n allowed_regions:\n - \"EU\"\n - \"EEA\"\n require_scc_for_external: true\n approved_subprocessors: []\n";
2381
2383
  declare const STARTER_TASK_TEMPLATE = "---\ntasks:\n - id: \"TSK-001-setup\"\n title: \"Initial component setup\"\n complexity: \"LOW\"\n risk-level: \"LOW\"\n autonomy-mode: \"AUTONOMOUS\"\n assigned-to: \"agent-developer\"\n status: \"PENDING\"\n verification:\n method: \"COMMAND_VERIFICATION\"\n command-or-criteria: \"pnpm test\"\n---\n\n# Task Plan: Component\n";
2382
2384
  declare const STARTER_REQUIREMENT_TEMPLATE = "---\nid: \"FR-SAMPLE-001\"\ntype: \"requirement\"\ntitle: \"Sample Feature\"\nstatus: \"active\"\nversion: \"1.0.0\"\ncategory: \"functional\"\nderives-from:\n - \"UC-SAMPLE-USECASE\"\nverifiable-by: \"cucumber-bdd\"\nacceptance-format: \"gherkin\"\ncucumber-tags:\n - \"@FR-SAMPLE-001\"\n---\n\n# Requirement: Sample Feature\n\n```gherkin\nFeature: Sample Feature\n Scenario: Basic execution\n Given system is ready\n When user triggers action\n Then system responds with 200 OK\n```\n";
package/dist/index.d.ts CHANGED
@@ -2339,6 +2339,8 @@ interface SpecializedAgentTemplate {
2339
2339
  title: string;
2340
2340
  description: string;
2341
2341
  globs: string;
2342
+ claudeTools?: readonly string[];
2343
+ antigravityTools?: readonly string[];
2342
2344
  body: string;
2343
2345
  }
2344
2346
  declare const SPECIALIZED_AGENT_TEMPLATES: readonly SpecializedAgentTemplate[];
@@ -2365,9 +2367,9 @@ declare const STARTER_CURSOR_PRODUCT_RULES = "---\ndescription: Directives for S
2365
2367
  declare const STARTER_CURSOR_QUALITY_RULES = "---\ndescription: Directives for code quality, architecture, TDD, and complexity limits\nglobs: packages/**, src/**, scripts/**, tests/**\nalwaysApply: false\n---\n\n# Code Quality and Architecture Directives\n\nCanonical Reference: [`process/09_agent_protocols.md`](process/09_agent_protocols.md) and [`process/10_quality_management_and_release_gates.md`](process/10_quality_management_and_release_gates.md).\n\n## 1. Non-Negotiable Quality Thresholds (`quality-policy.yaml`)\n- **Cyclomatic Complexity (CC)**: $\\le 10$ per function (warning alert if $> 7$).\n- **Cognitive Complexity**: $\\le 15$ per function (warning if $> 10$).\n- **Maintainability Index (MI)**: $\\ge 50$ (target minimum $\\ge 65$).\n- **Function Length**: $\\le 40$ lines (warning if $> 30$).\n- If a function exceeds these limits, decompose logic into cohesive helper functions before completing the task.\n\n## 2. TDD Methodology, Modular & Hexagonal Architecture (Ports & Adapters) & Unit Testing\n- **Mandatory 4-Step Implementation Order**: (1) Define/refine Modular & Hexagonal Architecture (Ports & Adapters) module boundaries, (2) Define interfaces/ports for all inter-module interactions to avoid direct module coupling, (3) Implement components consuming/fulfilling those interfaces, (4) Write unit tests for every function covering Happy Path, Sad Path, Boundary Values, and Unexpected/Null/Empty values.\n- Apply Test-Driven Development: generate unit tests before or alongside component logic.\n- Tag tests linked to requirements with header comments citing the ID (`FR-*`, `SEC-REQ-*`, or `PRIV-REQ-*`) to enable reverse traceability.\n- Suppressing types (`any`), linter rules (`eslint-disable`), or unit tests to force pipeline passage is prohibited.\n- **Mandatory Regression Verification**: Never declare build, typecheck, or bug fixes complete without executing the relevant automated test suite (`pnpm test`, `dotnet test`) and confirming zero regressions.\n- **Global Styles Protection**: When touching or refactoring frontend views, verify that global stylesheet/asset imports remain intact and that layouts suffer no visual disruption.\n\n## 3. Open Source License Policy (`license-policy.yaml`)\n- Before adding any dependency to `package.json`, verify its SPDX identifier.\n- Only permissive dependencies are allowed (`MIT`, `Apache-2.0`, `BSD-2/3-Clause`, `ISC`).\n- Viral licenses (`GPL`, `AGPL`) or commercial licenses without approval (`BSL`, `SSPL`) are prohibited.\n\n## 4. Structured Output `--json`\n- Any extension to CLI commands must preserve compatibility with the `--json` flag and suppress ANSI escape codes when this flag is present.\n";
2366
2368
  declare const STARTER_CLAUDE_RULES = "# Claude Code Instructions - AI-SDLC Monorepo\n\nCanonical Reference: [`process/09_agent_protocols.md`](process/09_agent_protocols.md) and [`process/01_governance_and_roles.md`](process/01_governance_and_roles.md).\n\nThis repository implements the **AI-SDLC** framework (Spec-Driven Development, deterministic quality governance, Privacy-by-Design, and OSS license compliance for human-agent collaboration).\n\n---\n\n## 1. The 5 Unbreakable Commandments of Agents | Los 5 Mandamientos Inquebrantables de los Agentes\n\n1. **FORBIDDEN TO AUTO-APPROVE OR AUTO-MERGE | PROHIBIDO AUTO-APROBAR O AUTO-FUSIONAR**: Never approve PRs or merge directly to `main` or protected branches. Approval is exclusively a human prerogative.\n2. **FORBIDDEN TO INVENT PRODUCT OR ARCHITECTURE DECISIONS**: When facing ambiguous requirements, formulate open questions (`open-questions`). Never assume undocumented behaviors.\n3. **FORBIDDEN TO INTRODUCE DEPENDENCIES WITHOUT LICENSE INSPECTION**: Always validate the SPDX identifier against `license-policy.yaml`. Viral libraries (`GPL`/`AGPL`) or paid commercial libraries (`BSL`/`SSPL`) are strictly forbidden without formal human approval.\n4. **FORBIDDEN TO IGNORE CYBERSECURITY & PRIVACY (SECURITY-BY-DEFAULT & PRIVACY-BY-DEFAULT)**: Validate inputs, sanitize data, protect PII according to `privacy-policy.yaml`, and include mitigation tests (`SEC-TEST-*`, `@privacy`). Disabling linters or suppressing typing errors (`any`, `@ts-ignore`) is prohibited.\n5. **MANDATORY CRYPTOGRAPHIC CITATION**: Every spec or sidecar must cite immutable identifiers and Unix LF-normalized SHA-256 digests.\n\n---\n\n## 2. Essential Execution and Pre-Flight Commands\n\n```bash\n# 1. Pre-flight with deterministic auto-fix (Gherkin & SHA-256 digests)\npnpm run check:fix\n\n# 2. Complete verification across all Quality Gates (Quality, RTM, Governance, Testing, Licenses, PDaC, Schemas, Duplicates, Security, Privacy)\npnpm run verify:all\n\n# 3. Complete automated test suite (Vitest)\npnpm test\n\n# 4. Strict TypeScript typechecking\npnpm run typecheck\n\n# 5. Scaffolding for a new SDD change\npnpm run change:new <name> --id <chg-id>\n\n# 6. Canonical integration of a completed SDD change\nnpx tsx packages/cli/src/index.ts sdd integrate --change <chg-id>\n```\n\n---\n\n## 3. Specialized Roles Mapping\n\n### 1. `agent-product-analyst` (Product Analyst / Scribe)\n- **Mission**: Capture new product intent via NAF v4 Enterprise & Capability Vision (`ARCH-INTRO-*`) and define/refine the product model using ProductShape.\n- **Phase 0 (Greenfield Product Inception)**: When creating a new product from scratch (or when `specs/product/` has no baseline), run a concise 3\u20135 question discovery interview (mission/problem, actors `ACT-*`, MVP capabilities `UC-*`, priority quality goals `QR-*`), draft `ARCH-INTRO-001` (`templates/architecture/introduction-and-goals.template.md`), and derive initial `ACT-*`, `UC-*`, `BR-*`, `FR-*`, and `QR-*` drafts.\n- **Input**: Business intent or natural language specification.\n- **Output**: Markdown artifacts with YAML frontmatter compliant with `schemas/architecture/introduction-and-goals.schema.json` (`ARCH-INTRO-*`) and `schemas/product/` (`ACT-*`, `UC-*`, `FR-*`, `QR-*`, `BR-*`).\n- **Guardrails**: `status` always starts in `draft`. Mandatory Gherkin criteria with `@<ID> @automated @regression`.\n\n### 2. `agent-threat-modeler` (Threat Modeler and Security Specialist)\n- **Mission**: Analyze use cases and proactively model adversaries, STRIDE attack vectors, and OWASP ASVS mitigations, both at product level and in the technical security feedback loop over architecture, handing off to `agent-privacy-officer`.\n- **Output**: Cybersecurity triad (`ACT-THREAT-*`, `ABUSE-*`, `SEC-REQ-*`) compliant with `schemas/security/`.\n\n### 3. `agent-privacy-officer` (Data Protection & Privacy-by-Design Specialist)\n- **Mission**: Receive handoff from `agent-threat-modeler` to model personal data assets (`DATA-ASSET-*`), GDPR Art. 30 records of processing (`PRIV-ROPA-*`), and LINDDUN / GDPR / ISO 27701 privacy requirements (`PRIV-REQ-*`), and audit code diffs against `privacy-policy.yaml`.\n- **Directives**: Run `pnpm run verify:privacy`, enforce PII masking in logs/LLM prompts, and trigger `DPIA-*` requests on Art. 9 sensitive data.\n\n### 4. `agent-system-architect` (System Architect)\n- **Mission**: Translate the approved product definition into a modular technical architecture based on arc42 enriched with NAF v4 (`CMP-*`, Mermaid diagrams, `ADR-*`).\n- **Guardrails**: Declare `satisfies-requirements` on every `CMP-*` (including `PRIV-REQ-*`), structure components following **Modular & Hexagonal Architecture (Ports & Adapters)** (Domain/Application Core + Inbound/Outbound Ports), instantiate mandatory building block `CMP-OBSERVABILITY` (Level 2/3) alongside Section 8 and an ADR for runtime telemetry, and trigger the technical security/privacy feedback loop toward `agent-threat-modeler` \u2794 `agent-privacy-officer` when infrastructure decisions introduce new attack vectors or PII flows.\n\n### 5. `agent-qa-engineer` (QA Engineer and SDET)\n- **Mission**: Translate approved requirements (`FR-*`, `SEC-REQ-*`, `PRIV-REQ-*`, `QR-*`) into comprehensive FAILING (red) BDD/Gherkin, End-to-End (E2E), UI, and unit test suites, before `agent-developer` writes production code.\n- **Guardrails**: Always use the agreed project technology/testing stack (if any). Never omit End-to-End (E2E) and UI tests. Create specific tests for every interactive UI element using external tools such as Playwright or FlatUI (or the agreed project testing technology), covering Happy Path, Sad Path, and Boundary Values. FORBIDDEN to include production code. Mandatory tags: `@<FR-ID> @automated @regression`.\n\n### 6. `agent-developer` (Software Developer)\n- **Mission**: Implement atomic tasks from SDD specifications (`tasks.md`) with clean, strictly typed code and thorough tests.\n- **Directives**: Execute the mandatory 4-step order: (1) Modular & Hexagonal Architecture (Ports & Adapters) definition/redefinition, (2) Inter-module interfaces first, (3) Component implementation, (4) Per-function unit tests (Happy Path, Sad Path, Boundary Values, Unexpected/Null/Empty values). Respect the autonomy mode. Make tests delivered by `agent-qa-engineer` pass green. Run `pnpm run check:fix` and `pnpm run verify:all`. Enforce Mandatory Regression Verification (`pnpm test`) with zero regressions before declaring completion, and enforce Global Styles Protection on frontend views.\n\n### 7. `agent-security-auditor` (Adversarial Code Auditor)\n- **Mission**: Examine Pull Requests for business logic vulnerabilities, injection vectors, secret leaks, and authorization flaws as part of the Pre-Merge Audit Triad.\n- **Directives**: Run `pnpm run verify:security`, evaluate CVSS v3.1 severity, and block CRITICAL/HIGH risks.\n\n### 8. `agent-compliance-checker` (Open Source License Compliance Auditor)\n- **Mission**: Audit dependency manifests against `license-policy.yaml` as part of the Pre-Merge Audit Triad.\n- **Directives**: Run `pnpm run verify:licenses`, blocking viral (`GPL`, `AGPL`) or unapproved commercial (`BSL`, `SSPL`) packages.\n\n### 9. `agent-expert-user` (Expert User and Domain Evaluator)\n- **Mission**: Contrast design and specifications (design phase) and functionally validate finished software against `UC-*` and `FR-*` (post-development functional validation phase).\n\n### 10. `agent-code-reviewer` (Technical and Architectural Code Reviewer)\n- **Mission**: Audit Pull Requests evaluating code cleanliness, adherence to SOLID, DRY, YAGNI principles, and respect for `quality-policy.yaml` thresholds, forming part of the Pre-Merge Audit Triad.\n- **Findings classification**: `[BLOCKING]`, `[CLEAN_CODE_SUGGESTION]`, `[COMPLIANT]`.\n\n### 11. `agent-devops` (Automation and Infrastructure Engineer)\n- **Mission**: Maintain, evolve, and audit automated project infrastructure: CI/CD workflows, Docker containers, IaC manifests, and support scripts.\n- **NON-INVASION GUARDRAIL**: STRICTLY FORBIDDEN from modifying application source code (`src/`, `packages/*/src/`).\n\n---\n\n## 4. Task Autonomy Modes (`tasks.md`)\n\n- \uD83D\uDFE2 **`AUTONOMOUS`**: Low risk, isolated task. Implement code and tests directly. Omit interactive handoff block.\n- \uD83D\uDFE1 **`HUMAN_REVIEW_PLAN`**: Medium risk. Design detailed plan, emit Workflow Handoff block, and wait for human confirmation before coding.\n- \uD83D\uDFE0 **`AMBIGUOUS`**: Incomplete requirements. Blocked: request human clarification.\n- \uD83D\uDD34 **`HIGH_RISK_MANUAL`**: Critical risk (migrations, cryptography). Direct manual execution by humans only.\n\n---\n\n## 5. Git Workflow and Commit Rules with Trailers\n\n### 4-Tier Hierarchy\n1. **Tier 1 (`main`)**: Absolute stability and production readiness.\n2. **Tier 2 (`release/vX.Y.Z`)**: Release stabilization.\n3. **Tier 3 (`feat/<FEAT-ID>-<slug>` or `bug/<BUG-ID>-<slug>`)**: SDD delivery increment.\n4. **Tier 4 (`task/<PARENT-ID>/<TSK-ID>-<slug>`)**: Atomic implementation task.\n\n### Commit Format (Conventional Commits + Git Trailers)\n```text\nfeat(scope): concise imperative description (#issue)\n\nBody explaining the motivation and technical justification of the change.\n\nAuthor-Type: agent\nAI-Model: claude-3-7-sonnet\nTask-ID: TSK-001\nChange-ID: CHG-026-AGENT-NATIVE-CONFIGS\n```\n\n---\n\n## 6. Non-Negotiable Quality Thresholds (`quality-policy.yaml`)\n- **Cyclomatic Complexity (CC)**: $\\le 10$\n- **Cognitive Complexity**: $\\le 15$\n- **Maintainability Index (MI)**: $\\ge 50$\n- **Lines per Function**: $\\le 40$\n- Deterministic CLI output: every `verify` command supports `--json` without ANSI escape codes.\n\n---\n\n## 7. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\u00F3n Humana\n- **Conditional Activation**:\n - \uD83D\uDFE2 **`AUTONOMOUS`** (or PR/CI final supervision): **OMITTED**. Uninterrupted continuous execution.\n - \uD83D\uDFE1 **Autonomy $\\ge$ `HUMAN_REVIEW_PLAN`** (`HUMAN_REVIEW_PLAN`, `AMBIGUOUS`, `HIGH_RISK_MANUAL`): **MANDATORY**. Emit Workflow Handoff block ([`templates/workflow/agent-handoff.template.md`](templates/workflow/agent-handoff.template.md)) and **STOP**.\n- **Content**: Completed deliverables, suggested next role(s), copy-paste ready invocation prompt, and **an open Human Action Window for the user to take action** (review, edit by hand, pause/reroute, or delegate).\n";
2367
2369
  declare const STARTER_COPILOT_RULES = "<!--\n AI-SDLC: Canonical Instructions for GitHub Copilot (Chat & Workspace)\n Canonical Reference: process/09_agent_protocols.md and process/01_governance_and_roles.md\n-->\n\n# GitHub Copilot Instructions - AI-SDLC Framework\n\nYou operate as an assistant agent in the **AI-SDLC** repository. You are not a simple text auto-completer: you are a specialized technical worker subject to normative directives, deterministic autonomy boundaries, and strict traceability.\n\n---\n\n## 1. The 5 Unbreakable Commandments of Agents | Los 5 Mandamientos Inquebrantables de los Agentes\n\n1. **FORBIDDEN TO AUTO-APPROVE OR AUTO-MERGE | PROHIBIDO AUTO-APROBAR O AUTO-FUSIONAR**:\n - Never execute PR approvals or direct merges to stable branches (`main`, `release/*`). Approval is an exclusive human prerogative.\n2. **FORBIDDEN TO INVENT PRODUCT OR ARCHITECTURE DECISIONS**:\n - If a requirement is ambiguous or incomplete, formulate open questions (`open-questions`) to the human user. Guessing undocumented intentions is forbidden.\n3. **FORBIDDEN TO INTRODUCE DEPENDENCIES WITHOUT LICENSE INSPECTION**:\n - Before suggesting or adding dependencies to manifests (`package.json`, etc.), validate their SPDX identifier against `license-policy.yaml`. Adding viral (`GPL`, `AGPL`) or commercial paid (`BSL`, `SSPL`) licenses without human authorization is prohibited.\n4. **FORBIDDEN TO IGNORE CYBERSECURITY & PRIVACY (SECURITY-BY-DEFAULT & PRIVACY-BY-DEFAULT)**:\n - All code must enforce least privilege, sanitize external inputs, protect PII according to `privacy-policy.yaml`, and include mitigation tests (`SEC-TEST-*`, `@privacy`). Suppressing types (`any`), linters, or tests to force a green pipeline is prohibited.\n5. **MANDATORY CRYPTOGRAPHIC CITATION**:\n - Every specification, design, or sidecar must reference canonical identifiers and their Unix LF-normalized SHA-256 digests.\n\n---\n\n## 2. Git 4-Tier Branch Hierarchy\n\nWhen proposing or creating branches, respect the strict hierarchical structure:\n- **Tier 1**: `main` (Protected production branch with maximum stability).\n- **Tier 2**: `release/vX.Y.Z` (Release consolidation and scope freeze branch).\n- **Tier 3**: `feat/<FEAT-ID>-<slug>` or `bug/<BUG-ID>-<slug>` (SDD increment or feature branch).\n- **Tier 4**: `task/<PARENT-ID>/<TSK-ID>-<slug>` (Atomic development task branch).\n\n---\n\n## 3. Pre-Flight Commands and Quality Gates\n\nBefore concluding any intervention or suggesting a commit:\n- **Unified pre-flight with auto-fix**: `pnpm run check:fix` (or `npx aisdlc check --fix`).\n- **Complete Quality Gates verification**: `pnpm run verify:all` (or `npx aisdlc verify all`).\n- **Unit test suite**: `pnpm test`.\n- **Strict typing**: `pnpm run typecheck`.\n\nNon-Negotiable Quality Thresholds (`quality-policy.yaml`):\n- Cyclomatic Complexity (CC) $\\le 10$.\n- Cognitive Complexity $\\le 15$.\n- Maintainability Index (MI) $\\ge 50$.\n- Maximum lines per function $\\le 40$.\n\n---\n\n## 4. Task Autonomy Modes (`tasks.md`)\n\n- \uD83D\uDFE2 **`AUTONOMOUS`**: Low risk, isolated task. Implement code and tests directly. Omit interactive handoff block.\n- \uD83D\uDFE1 **`HUMAN_REVIEW_PLAN`**: Medium risk. Design detailed plan, emit Workflow Handoff block, and wait for human confirmation before coding.\n- \uD83D\uDFE0 **`AMBIGUOUS`**: Incomplete requirements. Blocked: request human clarification.\n- \uD83D\uDD34 **`HIGH_RISK_MANUAL`**: Critical risk (migrations, cryptography). Direct manual execution by humans only.\n\n---\n\n## 5. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\u00F3n Humana\n- **Conditional Activation**:\n * \uD83D\uDFE2 **`AUTONOMOUS` Mode** (or PR/CI final supervision): **OMITTED**. Do not interrupt unattended execution.\n * \uD83D\uDFE1 **Autonomy $\\ge$ `HUMAN_REVIEW_PLAN`** (`HUMAN_REVIEW_PLAN`, `AMBIGUOUS`, `HIGH_RISK_MANUAL`): **MANDATORY**. Emit Workflow Handoff block compliant with [`templates/workflow/agent-handoff.template.md`](../templates/workflow/agent-handoff.template.md) and **STOP**.\n- **Components**: Declare completed deliverables, recommend next roles (`agent-threat-modeler`, `agent-privacy-officer`, `agent-system-architect`, `agent-developer`, `agent-security-auditor`), provide suggested invocation prompt, and **keep the Human Action Window open at all times for the user to take action** (review, edit by hand, pause/reroute, or delegate).\n\n---\n\n## 6. Specialized Roles Mapping\n\n| Role | Mission (summary) |\n| :--- | :--- |\n| `agent-product-analyst` | Phase 0 NAF v4 Enterprise & Capability Vision (`ARCH-INTRO-*`, 3\u20135 question interview) + ProductShape artifacts (`ACT-*`, `UC-*`, `FR-*`, `QR-*`, `BR-*`); `status` starts `draft`. |\n| `agent-threat-modeler` | STRIDE/OWASP threat triad (`ACT-THREAT-*`, `ABUSE-*`, `SEC-REQ-*`); hands off to `agent-privacy-officer`. |\n| `agent-privacy-officer` | LINDDUN & GDPR/LOPDGDD privacy triad (`DATA-ASSET-*`, `PRIV-ROPA-*`, `PRIV-REQ-*`) + Pre-Merge `verify:privacy`. |\n| `agent-system-architect` | Modular arc42 + NAF v4 architecture (`CMP-*`, Mermaid diagrams, `ADR-*`). |\n| `agent-qa-engineer` | FAILING BDD/Gherkin, E2E, and UI suites (using agreed project tech; Happy Path, Sad Path & Boundary Values per interactive UI element) before `agent-developer` writes production code. |\n| `agent-developer` | Atomic tasks from `tasks.md`; autonomy mode must be respected; runs `pnpm run check:fix` + `pnpm run verify:all`. |\n| `agent-security-auditor` | Adversarial PR security audit, SAST, secrets, and CVSS v3.1 evaluation. |\n| `agent-compliance-checker` | SPDX license compliance audit against `license-policy.yaml`. |\n| `agent-expert-user` | Bimodal MVP evaluation (design) and functional validation against `UC-*` and `FR-*` (pre-PR). |\n| `agent-code-reviewer` | PR audit (SOLID, DRY, YAGNI): `[BLOCKING]` / `[CLEAN_CODE_SUGGESTION]` / `[COMPLIANT]`. |\n| `agent-devops` | CI/CD, Docker, IaC only \u2014 **FORBIDDEN** to touch `src/` or `packages/*/src/`. |\n\n---\n\n## 7. Canonical Reference\nTo consult full protocols, specialized prompts, and interface contracts:\n- [`process/09_agent_protocols.md`](../process/09_agent_protocols.md)\n- [`process/01_governance_and_roles.md`](../process/01_governance_and_roles.md)\n";
2368
- declare const STARTER_CURSOR_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ]\n }\n }\n}\n";
2369
- declare const STARTER_ANTIGRAVITY_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ]\n }\n }\n}\n";
2370
- declare const STARTER_VSCODE_MCP = "{\n \"servers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ]\n }\n }\n}\n";
2370
+ declare const STARTER_CURSOR_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ],\n \"env\": {\n \"AISDLC_MCP_ROLE\": \"developer\"\n }\n }\n }\n}\n";
2371
+ declare const STARTER_ANTIGRAVITY_MCP = "{\n \"mcpServers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ],\n \"env\": {\n \"AISDLC_MCP_ROLE\": \"developer\"\n }\n }\n }\n}\n";
2372
+ declare const STARTER_VSCODE_MCP = "{\n \"servers\": {\n \"ai-sdlc\": {\n \"command\": \"npx\",\n \"args\": [\n \"@aisdlc/mcp\"\n ],\n \"env\": {\n \"AISDLC_MCP_ROLE\": \"developer\"\n }\n }\n }\n}\n";
2371
2373
 
2372
2374
  /**
2373
2375
  * AI-SDLC: Core Project Initialization and Governance Setup
@@ -2376,7 +2378,7 @@ declare const STARTER_VSCODE_MCP = "{\n \"servers\": {\n \"ai-sdlc\": {\n
2376
2378
  declare const VALID_CI_PROVIDERS: readonly ["github", "gitlab", "azure", "bitbucket"];
2377
2379
  type SupportedCiProvider = (typeof VALID_CI_PROVIDERS)[number];
2378
2380
  declare const STARTER_QUALITY_POLICY = "# ==============================================================================\n# AI-SDLC: Software Quality, Coding Rules & Release Gate Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nenforcement_mode: \"STRICT\"\n\nscope:\n target_directories:\n - \"src\"\n - \"lib\"\n supported_extensions:\n - \".ts\"\n - \".js\"\n - \".py\"\n - \".java\"\n - \".go\"\n - \".cs\"\n - \".rs\"\n - \".cpp\"\n - \".c\"\n exclude_patterns:\n - \"node_modules\"\n - \"__pycache__\"\n - \".pytest_cache\"\n - \"target\"\n - \"bin\"\n - \"obj\"\n - \".git\"\n - \"reports\"\n - \"dist\"\n - \".changeset\"\n - \"examples\"\n - \"scratch\"\n - \"templates\"\n\nthresholds:\n cyclomatic_complexity:\n max_per_function: 10\n cognitive_complexity:\n max_per_function: 15\n maintainability_index:\n min_acceptable_score: 50.0\n function_length:\n max_function_lines: 40\n";
2379
- declare const STARTER_LICENSE_POLICY = "# ==============================================================================\n# AI-SDLC: Open Source License Compliance & Governance Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\ndefault_action: \"DENY\"\n\ncategories:\n permissive_free:\n action: \"ALLOW\"\n description: \"Permissive commercial use licenses. Attribution only required.\"\n spdx_identifiers:\n - \"MIT\"\n - \"Apache-2.0\"\n - \"BSD-2-Clause\"\n - \"BSD-3-Clause\"\n - \"ISC\"\n - \"Unlicense\"\n - \"CC0-1.0\"\n - \"0BSD\"\n\n weak_copyleft_conditional:\n action: \"REVIEW_REQUIRED\"\n description: \"Allowed only as dynamically linked decoupled libraries.\"\n spdx_identifiers:\n - \"LGPL-2.1-only\"\n - \"LGPL-3.0-only\"\n - \"MPL-2.0\"\n\n strong_copyleft_viral:\n action: \"DENY\"\n description: \"Forbidden due to viral copyleft forcing source code disclosure.\"\n spdx_identifiers:\n - \"GPL-2.0-only\"\n - \"GPL-3.0-only\"\n - \"AGPL-3.0-only\"\n - \"AGPL-3.0-or-later\"\n\n commercial_acquisition_required:\n action: \"COMMERCIAL_APPROVAL_REQUIRED\"\n description: \"Source-available code requiring commercial license for SaaS deployment.\"\n spdx_identifiers:\n - \"SSPL-1.0\"\n - \"BSL-1.1\"\n";
2381
+ declare const STARTER_LICENSE_POLICY = "# ==============================================================================\n# AI-SDLC: Open Source License Compliance & Governance Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\ndefault_action: \"DENY\"\n\ncategories:\n permissive_free:\n action: \"ALLOW\"\n description: \"Permissive commercial use licenses. Attribution only required.\"\n spdx_identifiers:\n - \"MIT\"\n - \"Apache-2.0\"\n - \"BSD-2-Clause\"\n - \"BSD-3-Clause\"\n - \"ISC\"\n - \"Unlicense\"\n - \"CC0-1.0\"\n - \"0BSD\"\n - \"Python-2.0\"\n - \"BlueOak-1.0.0\"\n - \"Zlib\"\n - \"CC-BY-3.0\"\n - \"CC-BY-4.0\"\n - \"MS-PL\"\n\n weak_copyleft_conditional:\n action: \"REVIEW_REQUIRED\"\n description: \"Allowed only as dynamically linked decoupled libraries.\"\n spdx_identifiers:\n - \"LGPL-2.1-only\"\n - \"LGPL-2.1-or-later\"\n - \"LGPL-3.0-only\"\n - \"LGPL-3.0-or-later\"\n - \"MPL-2.0\"\n - \"EPL-2.0\"\n - \"CDDL-1.0\"\n - \"MS-RL\"\n - \"MS-LPL\"\n - \"MS-LRL\"\n\n strong_copyleft_viral:\n action: \"DENY\"\n description: \"Forbidden due to viral copyleft forcing source code disclosure.\"\n spdx_identifiers:\n - \"GPL-2.0-only\"\n - \"GPL-3.0-only\"\n - \"AGPL-3.0-only\"\n - \"AGPL-3.0-or-later\"\n\n commercial_acquisition_required:\n action: \"COMMERCIAL_APPROVAL_REQUIRED\"\n description: \"Source-available code requiring commercial license for SaaS deployment.\"\n spdx_identifiers:\n - \"SSPL-1.0\"\n - \"BSL-1.1\"\n";
2380
2382
  declare const STARTER_PRIVACY_POLICY = "# ==============================================================================\n# AI-SDLC: Data Protection & Privacy-by-Design Governance Policy (PDaC)\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nregulatory_frameworks:\n - \"GDPR\"\n - \"LOPDGDD\"\n - \"ISO-27701\"\ndefault_pii_action: \"DENY_UNCLASSIFIED\"\n\nclassification_levels:\n PUBLIC:\n encryption_at_rest: false\n encryption_in_transit: true\n allow_in_logs: true\n allow_in_llm_prompts: true\n INTERNAL:\n encryption_at_rest: true\n encryption_in_transit: true\n allow_in_logs: true\n allow_in_llm_prompts: true\n CONFIDENTIAL_PII:\n encryption_at_rest: true\n encryption_in_transit: true\n allow_in_logs: false\n masking_in_logs: \"HASH_OR_REDACT\"\n allow_in_llm_prompts: false\n require_retention_policy: true\n require_erasure_mechanism: true\n RESTRICTED_SENSITIVE_PII:\n encryption_at_rest: true\n field_level_encryption: true\n encryption_in_transit: true\n allow_in_logs: false\n allow_in_llm_prompts: false\n require_dpia_approval: true\n require_explicit_consent_or_art9_basis: true\n\ncross_border_transfers:\n allowed_regions:\n - \"EU\"\n - \"EEA\"\n require_scc_for_external: true\n approved_subprocessors: []\n";
2381
2383
  declare const STARTER_TASK_TEMPLATE = "---\ntasks:\n - id: \"TSK-001-setup\"\n title: \"Initial component setup\"\n complexity: \"LOW\"\n risk-level: \"LOW\"\n autonomy-mode: \"AUTONOMOUS\"\n assigned-to: \"agent-developer\"\n status: \"PENDING\"\n verification:\n method: \"COMMAND_VERIFICATION\"\n command-or-criteria: \"pnpm test\"\n---\n\n# Task Plan: Component\n";
2382
2384
  declare const STARTER_REQUIREMENT_TEMPLATE = "---\nid: \"FR-SAMPLE-001\"\ntype: \"requirement\"\ntitle: \"Sample Feature\"\nstatus: \"active\"\nversion: \"1.0.0\"\ncategory: \"functional\"\nderives-from:\n - \"UC-SAMPLE-USECASE\"\nverifiable-by: \"cucumber-bdd\"\nacceptance-format: \"gherkin\"\ncucumber-tags:\n - \"@FR-SAMPLE-001\"\n---\n\n# Requirement: Sample Feature\n\n```gherkin\nFeature: Sample Feature\n Scenario: Basic execution\n Given system is ready\n When user triggers action\n Then system responds with 200 OK\n```\n";
package/dist/index.js CHANGED
@@ -13806,6 +13806,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13806
13806
  title: "Product Analyst / Scribe",
13807
13807
  description: "Assist the human Product Owner in exploring, modeling, and refining product definition using NAF v4 Enterprise & Capability Vision (ARCH-INTRO-*) and ProductShape (ACT-*, UC-*, FR-*, QR-*, BR-*).",
13808
13808
  globs: "product/**, specs/product/**, templates/product/**, templates/architecture/introduction-and-goals.template.md",
13809
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13810
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool", "ask_question"],
13809
13811
  body: `## Role & Mission
13810
13812
  - **Role**: Product Analyst Agent (\`agent-product-analyst\`) and Technical Scribe (AI as Scribe) of the AI-SDLC framework.
13811
13813
  - **Mission**: Capture new product intent via NAF v4 Enterprise & Capability Vision (\`ARCH-INTRO-*\`) and transform natural language business intent into canonical ProductShape artifacts (\`ACT-*\`, \`JRN-*\`, \`UC-*\`, \`BR-*\`, \`TERM-*\`, \`FR-*\`, \`QR-*\`) 100% compliant with JSON schemas.
@@ -13831,6 +13833,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13831
13833
  title: "Threat Modeler and Security Specialist",
13832
13834
  description: "Analyze business use cases and architecture artifacts to proactively model STRIDE adversaries, abuse cases, and OWASP ASVS security requirements.",
13833
13835
  globs: "security/**, specs/security/**, architecture/**",
13836
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13837
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13834
13838
  body: `## Role & Mission
13835
13839
  - **Role**: Threat Modeling and Shift-Left Cybersecurity Specialist Agent (\`agent-threat-modeler\`).
13836
13840
  - **Mission**: Analyze business use cases and architecture artifacts to proactively model adversaries, STRIDE attack vectors, and OWASP ASVS mitigation requirements.
@@ -13852,6 +13856,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13852
13856
  title: "Data Protection & Privacy-by-Design Specialist",
13853
13857
  description: "Model personal data assets (DATA-ASSET-*), GDPR Art. 30 records of processing (PRIV-ROPA-*), and LINDDUN/ISO 27701 privacy requirements (PRIV-REQ-*) on handoff from cybersecurity, and audit code diffs against privacy-policy.yaml.",
13854
13858
  globs: "privacy/**, specs/privacy/**, privacy-policy.yaml, templates/privacy/**, schemas/privacy/**",
13859
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13860
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13855
13861
  body: `## Role & Mission
13856
13862
  - **Role**: Data Protection & Privacy-by-Design Specialist Agent (\`agent-privacy-officer\`).
13857
13863
  - **Mission**: Receive the handoff from \`agent-threat-modeler\` to model personal data assets (\`DATA-ASSET-*\`), GDPR Art. 30 records of processing (\`PRIV-ROPA-*\`), and LINDDUN / GDPR Art. 25 / ISO 27701 privacy requirements (\`PRIV-REQ-*\`), and audit code changes in Pre-Merge against \`privacy-policy.yaml\`.
@@ -13877,6 +13883,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13877
13883
  title: "System Architect",
13878
13884
  description: "Translate approved product and security definitions into modular technical architecture based on arc42 enriched with NAF v4 (CMP-*, ADR-*).",
13879
13885
  globs: "architecture/**, specs/changes/**/design.md, templates/architecture/**",
13886
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13887
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13880
13888
  body: `## Role & Mission
13881
13889
  - **Role**: System Architect Agent (\`agent-system-architect\`) of the AI-SDLC framework.
13882
13890
  - **Mission**: Translate approved product definition into a modular technical architecture based on arc42 enriched with NAF v4.
@@ -13897,6 +13905,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13897
13905
  title: "QA Engineer and SDET",
13898
13906
  description: "Translate approved requirements (FR-*, SEC-REQ-*, PRIV-REQ-*, QR-*) into comprehensive FAILING (red) BDD/Gherkin, End-to-End (E2E), UI, and unit test suites before production code is written.",
13899
13907
  globs: "tests/**, specs/changes/**/spec.md",
13908
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13909
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13900
13910
  body: `## Role & Mission
13901
13911
  - **Role**: QA Engineer and SDET (Software Development Engineer in Test) Agent (\`agent-qa-engineer\`).
13902
13912
  - **Mission**: Translate approved requirements (\`FR-*\`, \`SEC-REQ-*\`, \`PRIV-REQ-*\`, \`QR-*\`) into comprehensive FAILING (red) BDD/Gherkin, End-to-End (E2E), UI, and unit test suites before \`agent-developer\` writes a single line of production code.
@@ -13926,6 +13936,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13926
13936
  title: "Software Developer",
13927
13937
  description: "Implement atomic tasks from SDD specifications (tasks.md) delivering clean, strictly typed, and tested code satisfying quality-policy.yaml thresholds.",
13928
13938
  globs: "src/**, packages/**, tests/**, specs/changes/**",
13939
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13940
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13929
13941
  body: `## Role & Mission
13930
13942
  - **Role**: High-Precision Software Developer / Coder Agent (\`agent-developer\`).
13931
13943
  - **Mission**: Implement atomic tasks from SDD specifications (\`tasks.md\`) delivering clean, strictly typed, and tested code.
@@ -13962,6 +13974,8 @@ Execute every implementation task following this strict sequential order:
13962
13974
  title: "Adversarial Code Auditor",
13963
13975
  description: "Examine Pull Requests and source code with an attacker mindset for business logic vulnerabilities, injection vectors, secret leaks, and authorization flaws.",
13964
13976
  globs: "src/**, packages/**, security/**",
13977
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
13978
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
13965
13979
  body: `## Role & Mission
13966
13980
  - **Role**: Adversarial Security Auditor Agent (\`agent-security-auditor\`).
13967
13981
  - **Mission**: Rigorously examine Pull Requests and code diffs for business logic vulnerabilities, injection vectors, secret leaks, and authorization flaws as part of the Pre-Merge Audit Triad.
@@ -13978,6 +13992,8 @@ Execute every implementation task following this strict sequential order:
13978
13992
  title: "Open Source License Compliance Auditor",
13979
13993
  description: "Audit dependency manifests and SBOMs against license-policy.yaml to block viral copyleft licenses and flag commercial license requirements.",
13980
13994
  globs: "package.json, pnpm-lock.yaml, license-policy.yaml, compliance/**",
13995
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
13996
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
13981
13997
  body: `## Role & Mission
13982
13998
  - **Role**: Open Source License and Intellectual Property Compliance Auditor Agent (\`agent-compliance-checker\`).
13983
13999
  - **Mission**: Audit dependency manifests and ensure every direct and transitive third-party package complies with \`license-policy.yaml\` as part of the Pre-Merge Audit Triad.
@@ -13993,6 +14009,8 @@ Execute every implementation task following this strict sequential order:
13993
14009
  title: "Expert User and Domain Evaluator",
13994
14010
  description: "Scrutinize product design (MVP vs roadmap) and functionally validate finished software against UC-* and FR-* acceptance criteria before pre-merge audit.",
13995
14011
  globs: "product/**, specs/**, src/**, packages/**",
14012
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
14013
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
13996
14014
  body: `## Role & Mission
13997
14015
  - **Role**: Expert User and Domain Evaluator Agent (\`agent-expert-user\`).
13998
14016
  - **Mission**: Scrutinize product design, technical specifications, and implemented software from the perspective of an advanced operator, enforcing strict MVP boundaries and pre-PR functional conformity.
@@ -14009,6 +14027,8 @@ Execute every implementation task following this strict sequential order:
14009
14027
  title: "Technical and Architectural Code Reviewer",
14010
14028
  description: "Audit Pull Requests for Clean Code, SOLID, DRY, YAGNI, design patterns, and compliance with quality-policy.yaml complexity and maintainability thresholds.",
14011
14029
  globs: "src/**, packages/**, tests/**",
14030
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
14031
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
14012
14032
  body: `## Role & Mission
14013
14033
  - **Role**: Technical and Architectural Code Reviewer Agent (\`agent-code-reviewer\`).
14014
14034
  - **Mission**: Audit Pull Requests evaluating code cleanliness, adherence to SOLID, DRY, YAGNI principles, design patterns, and compliance with complexity and maintainability thresholds (\`quality-policy.yaml\`), forming part of the Pre-Merge Audit Triad.
@@ -14027,6 +14047,8 @@ Execute every implementation task following this strict sequential order:
14027
14047
  title: "Automation and Infrastructure Engineer",
14028
14048
  description: "Maintain, evolve, and audit CI/CD workflows, Dockerfiles, IaC manifests, and support scripts under strict non-invasion guardrails on src/.",
14029
14049
  globs: ".github/workflows/**, templates/ci/**, scripts/**, Dockerfile*",
14050
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
14051
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
14030
14052
  body: `## Role & Mission
14031
14053
  - **Role**: DevOps and Infrastructure as Code (IaC) Engineer Agent (\`agent-devops\`).
14032
14054
  - **Mission**: Maintain, evolve, and audit automated project infrastructure: CI/CD workflows, Docker containers, deployment manifests, and infrastructure scripts.
@@ -14042,10 +14064,13 @@ Execute every implementation task following this strict sequential order:
14042
14064
  }
14043
14065
  ];
14044
14066
  function renderAntigravityAgentFile(agent) {
14067
+ const toolsSection = agent.antigravityTools && agent.antigravityTools.length > 0 ? `
14068
+ tools:
14069
+ ${agent.antigravityTools.map((t) => ` - ${t}`).join("\n")}` : "";
14045
14070
  return `---
14046
14071
  name: ${agent.id}
14047
14072
  description: >-
14048
- ${agent.description}
14073
+ ${agent.description}${toolsSection}
14049
14074
  ---
14050
14075
 
14051
14076
  # ${agent.id} (${agent.title})
@@ -14056,9 +14081,12 @@ ${agent.body}
14056
14081
  `;
14057
14082
  }
14058
14083
  function renderClaudeAgentFile(agent) {
14084
+ const toolsSection = agent.claudeTools && agent.claudeTools.length > 0 ? `
14085
+ tools:
14086
+ ${agent.claudeTools.map((t) => ` - ${t}`).join("\n")}` : "";
14059
14087
  return `---
14060
14088
  name: ${agent.id}
14061
- description: ${agent.description}
14089
+ description: ${agent.description}${toolsSection}
14062
14090
  ---
14063
14091
 
14064
14092
  # ${agent.id} (${agent.title})
@@ -14069,9 +14097,12 @@ ${agent.body}
14069
14097
  `;
14070
14098
  }
14071
14099
  function renderCopilotAgentFile(agent) {
14100
+ const toolsSection = agent.claudeTools && agent.claudeTools.length > 0 ? `
14101
+ tools:
14102
+ ${agent.claudeTools.map((t) => ` - ${t}`).join("\n")}` : "";
14072
14103
  return `---
14073
14104
  name: ${agent.id}
14074
- description: ${agent.description}
14105
+ description: ${agent.description}${toolsSection}
14075
14106
  ---
14076
14107
 
14077
14108
  # ${agent.id} (${agent.title})
@@ -14816,7 +14847,10 @@ var STARTER_CURSOR_MCP = `{
14816
14847
  "command": "npx",
14817
14848
  "args": [
14818
14849
  "@aisdlc/mcp"
14819
- ]
14850
+ ],
14851
+ "env": {
14852
+ "AISDLC_MCP_ROLE": "developer"
14853
+ }
14820
14854
  }
14821
14855
  }
14822
14856
  }
@@ -14827,7 +14861,10 @@ var STARTER_ANTIGRAVITY_MCP = `{
14827
14861
  "command": "npx",
14828
14862
  "args": [
14829
14863
  "@aisdlc/mcp"
14830
- ]
14864
+ ],
14865
+ "env": {
14866
+ "AISDLC_MCP_ROLE": "developer"
14867
+ }
14831
14868
  }
14832
14869
  }
14833
14870
  }
@@ -14838,7 +14875,10 @@ var STARTER_VSCODE_MCP = `{
14838
14875
  "command": "npx",
14839
14876
  "args": [
14840
14877
  "@aisdlc/mcp"
14841
- ]
14878
+ ],
14879
+ "env": {
14880
+ "AISDLC_MCP_ROLE": "developer"
14881
+ }
14842
14882
  }
14843
14883
  }
14844
14884
  }
@@ -16023,14 +16063,27 @@ categories:
16023
16063
  - "Unlicense"
16024
16064
  - "CC0-1.0"
16025
16065
  - "0BSD"
16066
+ - "Python-2.0"
16067
+ - "BlueOak-1.0.0"
16068
+ - "Zlib"
16069
+ - "CC-BY-3.0"
16070
+ - "CC-BY-4.0"
16071
+ - "MS-PL"
16026
16072
 
16027
16073
  weak_copyleft_conditional:
16028
16074
  action: "REVIEW_REQUIRED"
16029
16075
  description: "Allowed only as dynamically linked decoupled libraries."
16030
16076
  spdx_identifiers:
16031
16077
  - "LGPL-2.1-only"
16078
+ - "LGPL-2.1-or-later"
16032
16079
  - "LGPL-3.0-only"
16080
+ - "LGPL-3.0-or-later"
16033
16081
  - "MPL-2.0"
16082
+ - "EPL-2.0"
16083
+ - "CDDL-1.0"
16084
+ - "MS-RL"
16085
+ - "MS-LPL"
16086
+ - "MS-LRL"
16034
16087
 
16035
16088
  strong_copyleft_viral:
16036
16089
  action: "DENY"