@aisdlc/core 3.0.0 → 3.2.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
@@ -13836,6 +13836,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13836
13836
  title: "Product Analyst / Scribe",
13837
13837
  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-*).",
13838
13838
  globs: "product/**, specs/product/**, templates/product/**, templates/architecture/introduction-and-goals.template.md",
13839
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13840
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool", "ask_question"],
13839
13841
  body: `## Role & Mission
13840
13842
  - **Role**: Product Analyst Agent (\`agent-product-analyst\`) and Technical Scribe (AI as Scribe) of the AI-SDLC framework.
13841
13843
  - **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.
@@ -13861,6 +13863,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13861
13863
  title: "Threat Modeler and Security Specialist",
13862
13864
  description: "Analyze business use cases and architecture artifacts to proactively model STRIDE adversaries, abuse cases, and OWASP ASVS security requirements.",
13863
13865
  globs: "security/**, specs/security/**, architecture/**",
13866
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13867
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13864
13868
  body: `## Role & Mission
13865
13869
  - **Role**: Threat Modeling and Shift-Left Cybersecurity Specialist Agent (\`agent-threat-modeler\`).
13866
13870
  - **Mission**: Analyze business use cases and architecture artifacts to proactively model adversaries, STRIDE attack vectors, and OWASP ASVS mitigation requirements.
@@ -13882,6 +13886,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13882
13886
  title: "Data Protection & Privacy-by-Design Specialist",
13883
13887
  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.",
13884
13888
  globs: "privacy/**, specs/privacy/**, privacy-policy.yaml, templates/privacy/**, schemas/privacy/**",
13889
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13890
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13885
13891
  body: `## Role & Mission
13886
13892
  - **Role**: Data Protection & Privacy-by-Design Specialist Agent (\`agent-privacy-officer\`).
13887
13893
  - **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\`.
@@ -13907,6 +13913,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13907
13913
  title: "System Architect",
13908
13914
  description: "Translate approved product and security definitions into modular technical architecture based on arc42 enriched with NAF v4 (CMP-*, ADR-*).",
13909
13915
  globs: "architecture/**, specs/changes/**/design.md, templates/architecture/**",
13916
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13917
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13910
13918
  body: `## Role & Mission
13911
13919
  - **Role**: System Architect Agent (\`agent-system-architect\`) of the AI-SDLC framework.
13912
13920
  - **Mission**: Translate approved product definition into a modular technical architecture based on arc42 enriched with NAF v4.
@@ -13927,6 +13935,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13927
13935
  title: "QA Engineer and SDET",
13928
13936
  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.",
13929
13937
  globs: "tests/**, specs/changes/**/spec.md",
13938
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13939
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13930
13940
  body: `## Role & Mission
13931
13941
  - **Role**: QA Engineer and SDET (Software Development Engineer in Test) Agent (\`agent-qa-engineer\`).
13932
13942
  - **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.
@@ -13956,6 +13966,8 @@ var SPECIALIZED_AGENT_TEMPLATES = [
13956
13966
  title: "Software Developer",
13957
13967
  description: "Implement atomic tasks from SDD specifications (tasks.md) delivering clean, strictly typed, and tested code satisfying quality-policy.yaml thresholds.",
13958
13968
  globs: "src/**, packages/**, tests/**, specs/changes/**",
13969
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
13970
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
13959
13971
  body: `## Role & Mission
13960
13972
  - **Role**: High-Precision Software Developer / Coder Agent (\`agent-developer\`).
13961
13973
  - **Mission**: Implement atomic tasks from SDD specifications (\`tasks.md\`) delivering clean, strictly typed, and tested code.
@@ -13992,6 +14004,8 @@ Execute every implementation task following this strict sequential order:
13992
14004
  title: "Adversarial Code Auditor",
13993
14005
  description: "Examine Pull Requests and source code with an attacker mindset for business logic vulnerabilities, injection vectors, secret leaks, and authorization flaws.",
13994
14006
  globs: "src/**, packages/**, security/**",
14007
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
14008
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
13995
14009
  body: `## Role & Mission
13996
14010
  - **Role**: Adversarial Security Auditor Agent (\`agent-security-auditor\`).
13997
14011
  - **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.
@@ -14008,6 +14022,8 @@ Execute every implementation task following this strict sequential order:
14008
14022
  title: "Open Source License Compliance Auditor",
14009
14023
  description: "Audit dependency manifests and SBOMs against license-policy.yaml to block viral copyleft licenses and flag commercial license requirements.",
14010
14024
  globs: "package.json, pnpm-lock.yaml, license-policy.yaml, compliance/**",
14025
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
14026
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
14011
14027
  body: `## Role & Mission
14012
14028
  - **Role**: Open Source License and Intellectual Property Compliance Auditor Agent (\`agent-compliance-checker\`).
14013
14029
  - **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.
@@ -14023,6 +14039,8 @@ Execute every implementation task following this strict sequential order:
14023
14039
  title: "Expert User and Domain Evaluator",
14024
14040
  description: "Scrutinize product design (MVP vs roadmap) and functionally validate finished software against UC-* and FR-* acceptance criteria before pre-merge audit.",
14025
14041
  globs: "product/**, specs/**, src/**, packages/**",
14042
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
14043
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
14026
14044
  body: `## Role & Mission
14027
14045
  - **Role**: Expert User and Domain Evaluator Agent (\`agent-expert-user\`).
14028
14046
  - **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.
@@ -14039,6 +14057,8 @@ Execute every implementation task following this strict sequential order:
14039
14057
  title: "Technical and Architectural Code Reviewer",
14040
14058
  description: "Audit Pull Requests for Clean Code, SOLID, DRY, YAGNI, design patterns, and compliance with quality-policy.yaml complexity and maintainability thresholds.",
14041
14059
  globs: "src/**, packages/**, tests/**",
14060
+ claudeTools: ["View", "GlobTool", "GrepTool", "LS", "Bash"],
14061
+ antigravityTools: ["read_file", "run_command", "call_mcp_tool"],
14042
14062
  body: `## Role & Mission
14043
14063
  - **Role**: Technical and Architectural Code Reviewer Agent (\`agent-code-reviewer\`).
14044
14064
  - **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.
@@ -14057,6 +14077,8 @@ Execute every implementation task following this strict sequential order:
14057
14077
  title: "Automation and Infrastructure Engineer",
14058
14078
  description: "Maintain, evolve, and audit CI/CD workflows, Dockerfiles, IaC manifests, and support scripts under strict non-invasion guardrails on src/.",
14059
14079
  globs: ".github/workflows/**, templates/ci/**, scripts/**, Dockerfile*",
14080
+ claudeTools: ["View", "Edit", "Replace", "GlobTool", "GrepTool", "LS", "Bash"],
14081
+ antigravityTools: ["read_file", "edit_file", "write_file", "run_command", "call_mcp_tool"],
14060
14082
  body: `## Role & Mission
14061
14083
  - **Role**: DevOps and Infrastructure as Code (IaC) Engineer Agent (\`agent-devops\`).
14062
14084
  - **Mission**: Maintain, evolve, and audit automated project infrastructure: CI/CD workflows, Docker containers, deployment manifests, and infrastructure scripts.
@@ -14072,10 +14094,13 @@ Execute every implementation task following this strict sequential order:
14072
14094
  }
14073
14095
  ];
14074
14096
  function renderAntigravityAgentFile(agent) {
14097
+ const toolsSection = agent.antigravityTools && agent.antigravityTools.length > 0 ? `
14098
+ tools:
14099
+ ${agent.antigravityTools.map((t) => ` - ${t}`).join("\n")}` : "";
14075
14100
  return `---
14076
14101
  name: ${agent.id}
14077
14102
  description: >-
14078
- ${agent.description}
14103
+ ${agent.description}${toolsSection}
14079
14104
  ---
14080
14105
 
14081
14106
  # ${agent.id} (${agent.title})
@@ -14086,9 +14111,12 @@ ${agent.body}
14086
14111
  `;
14087
14112
  }
14088
14113
  function renderClaudeAgentFile(agent) {
14114
+ const toolsSection = agent.claudeTools && agent.claudeTools.length > 0 ? `
14115
+ tools:
14116
+ ${agent.claudeTools.map((t) => ` - ${t}`).join("\n")}` : "";
14089
14117
  return `---
14090
14118
  name: ${agent.id}
14091
- description: ${agent.description}
14119
+ description: ${agent.description}${toolsSection}
14092
14120
  ---
14093
14121
 
14094
14122
  # ${agent.id} (${agent.title})
@@ -14099,9 +14127,12 @@ ${agent.body}
14099
14127
  `;
14100
14128
  }
14101
14129
  function renderCopilotAgentFile(agent) {
14130
+ const toolsSection = agent.claudeTools && agent.claudeTools.length > 0 ? `
14131
+ tools:
14132
+ ${agent.claudeTools.map((t) => ` - ${t}`).join("\n")}` : "";
14102
14133
  return `---
14103
14134
  name: ${agent.id}
14104
- description: ${agent.description}
14135
+ description: ${agent.description}${toolsSection}
14105
14136
  ---
14106
14137
 
14107
14138
  # ${agent.id} (${agent.title})
@@ -14179,6 +14210,7 @@ Use this skill when starting a **brand-new software project from scratch (Greenf
14179
14210
  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.
14180
14211
 
14181
14212
  ## Non-Negotiable Guardrails
14213
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always spawn each specialist in a fresh isolated subagent context that reads state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14182
14214
  - **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-*\`.
14183
14215
  - 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.
14184
14216
  - All newly drafted specifications must start with \`status: draft\`.
@@ -14222,6 +14254,7 @@ Instead of attempting to document 100% of a legacy monolith upfront, apply **bou
14222
14254
  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).
14223
14255
 
14224
14256
  ## Non-Negotiable Guardrails
14257
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always spawn each specialist in a fresh isolated subagent context that reads state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14225
14258
  - **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-*\`).
14226
14259
  - **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\`).
14227
14260
  - **Immediate Secret Remediation**: If Step 2 (\`verify_security\`) uncovers leaked credentials (exit code 4), halt feature work and remediate/rotate secrets immediately.`
@@ -14290,6 +14323,7 @@ Use this skill for **every evolutionary increment (new feature, enhancement, ref
14290
14323
  - 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\`).
14291
14324
 
14292
14325
  ## Non-Negotiable Guardrails
14326
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles (e.g., \`agent-qa-engineer\` and \`agent-developer\`, or \`agent-developer\` and \`agent-security-auditor\`) in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always spawn each specialist in a fresh isolated subagent context that reads state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14293
14327
  - **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.
14294
14328
  - **100% Design & Handoff Coverage in \`tasks.md\`**: Every \`CMP-*\`, \`FR-*\`, \`SEC-REQ-*\`, and \`PRIV-REQ-*\` declared in \`design.md\` and \`handoff.yaml\` must be explicitly assigned to at least one \`TSK-*\` in \`tasks.md\`.`
14295
14329
  }
@@ -14481,6 +14515,7 @@ This file defines the operational rules and specialized role mappings for Google
14481
14515
  ---
14482
14516
 
14483
14517
  ## 4. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\xF3n Humana
14518
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always delegate each specialist phase to a fresh isolated subagent context that hydrates state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14484
14519
  - **Conditional Activation Rule by Autonomy**:
14485
14520
  - \u{1F7E2} **\`AUTONOMOUS\`** (or exclusive final supervision in PR/CI): **OMITTED**. Do not request or emit interactive handoff to avoid interrupting unattended execution.
14486
14521
  - \u{1F7E1} **Autonomy $\\ge$ \`HUMAN_REVIEW_PLAN\`** (\`HUMAN_REVIEW_PLAN\`, \`AMBIGUOUS\`, \`HIGH_RISK_MANUAL\`): **MANDATORY**. Emit the Workflow Handoff block compliant with [\`templates/workflow/agent-handoff.template.md\`](../../templates/workflow/agent-handoff.template.md) and **STOP**.
@@ -14539,6 +14574,7 @@ Before finalizing changes or proposing commits:
14539
14574
  - \u{1F534} **\`HIGH_RISK_MANUAL\`**: Critical risk. Human-only execution.
14540
14575
 
14541
14576
  ## 6. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\xF3n Humana
14577
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always delegate each specialist phase to a fresh isolated subagent context that hydrates state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14542
14578
  - **Conditional Activation**:
14543
14579
  * \u{1F7E2} **\`AUTONOMOUS\`** (or PR/CI supervision): **OMITTED**. Do not request or emit interactive handoff.
14544
14580
  * \u{1F7E1} **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**.
@@ -14743,6 +14779,7 @@ Change-ID: CHG-026-AGENT-NATIVE-CONFIGS
14743
14779
  ---
14744
14780
 
14745
14781
  ## 7. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\xF3n Humana
14782
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always delegate each specialist phase to a fresh isolated subagent context that hydrates state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14746
14783
  - **Conditional Activation**:
14747
14784
  - \u{1F7E2} **\`AUTONOMOUS\`** (or PR/CI final supervision): **OMITTED**. Uninterrupted continuous execution.
14748
14785
  - \u{1F7E1} **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**.
@@ -14810,6 +14847,7 @@ Non-Negotiable Quality Thresholds (\`quality-policy.yaml\`):
14810
14847
  ---
14811
14848
 
14812
14849
  ## 5. Workflow Handoff Protocol and Human Action Window | Ventana de Acci\xF3n Humana
14850
+ - **Clean Context Window Isolation per Specialist Agent (Cross-IDE)**: Never execute two distinct specialist roles in the same conversation context window. In subagent-capable IDEs (Antigravity \`invoke_subagent\`, Claude Code \`Task\` / \`.claude/agents/\`, GitHub Copilot \`@agent-*\`), always delegate each specialist phase to a fresh isolated subagent context that hydrates state strictly from disk (\`specs/\`, \`handoff.yaml\`, \`get_active_handoff\`). In chat-based IDEs (Cursor, Windsurf, Aider), persist all artifacts to disk, emit the Workflow Handoff block, and instruct the user to open a **New Chat** (or \`/clear\`) before running the next specialist.
14813
14851
  - **Conditional Activation**:
14814
14852
  * \u{1F7E2} **\`AUTONOMOUS\` Mode** (or PR/CI final supervision): **OMITTED**. Do not interrupt unattended execution.
14815
14853
  * \u{1F7E1} **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**.
@@ -14846,7 +14884,10 @@ var STARTER_CURSOR_MCP = `{
14846
14884
  "command": "npx",
14847
14885
  "args": [
14848
14886
  "@aisdlc/mcp"
14849
- ]
14887
+ ],
14888
+ "env": {
14889
+ "AISDLC_MCP_ROLE": "developer"
14890
+ }
14850
14891
  }
14851
14892
  }
14852
14893
  }
@@ -14857,7 +14898,10 @@ var STARTER_ANTIGRAVITY_MCP = `{
14857
14898
  "command": "npx",
14858
14899
  "args": [
14859
14900
  "@aisdlc/mcp"
14860
- ]
14901
+ ],
14902
+ "env": {
14903
+ "AISDLC_MCP_ROLE": "developer"
14904
+ }
14861
14905
  }
14862
14906
  }
14863
14907
  }
@@ -14868,7 +14912,10 @@ var STARTER_VSCODE_MCP = `{
14868
14912
  "command": "npx",
14869
14913
  "args": [
14870
14914
  "@aisdlc/mcp"
14871
- ]
14915
+ ],
14916
+ "env": {
14917
+ "AISDLC_MCP_ROLE": "developer"
14918
+ }
14872
14919
  }
14873
14920
  }
14874
14921
  }
@@ -15941,7 +15988,7 @@ Describes the adversary's profile, technical skill level, available resources, a
15941
15988
  | :--- | :--- | :--- | :--- | :--- |\r
15942
15989
  | **1.0.0** | 2026-09-03 | Security Officer / Threat Modeler | Initial threat profile characterization | CHG-SEC-001 |\r
15943
15990
  `;
15944
- var STARTER_TEMPLATES_WORKFLOW_AGENT_HANDOFF_TEMPLATE_MD = '# Workflow Handoff Template\r\n\r\n> **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).\r\n>\r\n> **Activation Criterion by Autonomy Mode:**\r\n> - \u{1F7E2} **`AUTONOMOUS` (or exclusive supervision at the end in PR/CI):** OMITTED. The agent executes and delivers without interrupting the user with this handoff block.\r\n> - \u{1F7E1} **`HUMAN_REVIEW_PLAN` | \u{1F7E0} `AMBIGUOUS` | \u{1F534} `HIGH_RISK_MANUAL`:** MANDATORY. Upon completing the phase or proposal, the agent emits this block and **halts**, granting visibility to the user and relinquishing control.\r\n\r\n---\r\n\r\n### \u{1F504} Workflow Handoff\r\n\r\n- **Completed Phase / Activity**: `[Current phase, e.g. Product Definition / Threat Modeling / Privacy Modeling / Architecture / SDD Implementation]`\r\n- **Acting Role**: `[agent-product-analyst | agent-threat-modeler | agent-privacy-officer | agent-system-architect | agent-developer | agent-expert-user | agent-security-auditor | agent-compliance-checker]`\r\n- **Task Autonomy Mode**: `[HUMAN_REVIEW_PLAN | AMBIGUOUS | HIGH_RISK_MANUAL]`\r\n- **Produced Deliverables**:\r\n - [x] `[Path or ID of generated artifact, e.g. specs/product/uc-mission.md]`\r\n - [x] `[Path or ID of generated artifact, e.g. quality-report.md]`\r\n\r\n- **Recommended Next Role(s) in Workflow**:\r\n - `[Suggested role name, e.g. agent-threat-modeler]`: `[Technical rationale, e.g. Model STRIDE adversaries and mitigate abuse cases]`\r\n - *(Optional)* `[Alternative role, e.g. agent-expert-user]`: `[Technical rationale, e.g. Evaluate UX and MVP boundary]`\r\n\r\n- **Suggested Invocation Prompt**:\r\n > "Act as `[next-role]` and proceed with the `[next phase]` phase on the generated deliverables: `[key artifacts]`."\r\n\r\n- **Human Action Window (User Sovereignty and Priority)**:\r\n - \u270B **Review and Validate**: Inspect generated artifacts and validate alignment with project vision before proceeding.\r\n - \u270F\uFE0F **Edit Directly**: Modify requirements, code, or acceptance criteria directly at any time.\r\n - \u{1F6D1} **Pause, Divert, or Discard**: Freeze workflow, redirect toward another goal, or discard proposal.\r\n - \u25B6\uFE0F **Delegate to Next Agent**: If satisfied with output, execute suggested prompt to continue the chain.\r\n\r\n---\r\n';
15991
+ var STARTER_TEMPLATES_WORKFLOW_AGENT_HANDOFF_TEMPLATE_MD = '# Workflow Handoff Template\r\n\r\n> **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).\r\n>\r\n> **Activation Criterion by Autonomy Mode:**\r\n> - \u{1F7E2} **`AUTONOMOUS` (or exclusive supervision at the end in PR/CI):** OMITTED. The agent executes and delivers without interrupting the user with this handoff block.\r\n> - \u{1F7E1} **`HUMAN_REVIEW_PLAN` | \u{1F7E0} `AMBIGUOUS` | \u{1F534} `HIGH_RISK_MANUAL`:** MANDATORY. Upon completing the phase or proposal, the agent emits this block and **halts**, granting visibility to the user and relinquishing control.\r\n\r\n---\r\n\r\n### \u{1F504} Workflow Handoff\r\n\r\n- **Completed Phase / Activity**: `[Current phase, e.g. Product Definition / Threat Modeling / Privacy Modeling / Architecture / SDD Implementation]`\r\n- **Acting Role**: `[agent-product-analyst | agent-threat-modeler | agent-privacy-officer | agent-system-architect | agent-developer | agent-expert-user | agent-security-auditor | agent-compliance-checker]`\r\n- **Task Autonomy Mode**: `[HUMAN_REVIEW_PLAN | AMBIGUOUS | HIGH_RISK_MANUAL]`\r\n- **Produced Deliverables**:\r\n - [x] `[Path or ID of generated artifact, e.g. specs/product/uc-mission.md]`\r\n - [x] `[Path or ID of generated artifact, e.g. quality-report.md]`\r\n\r\n- **Recommended Next Role(s) in Workflow**:\r\n - `[Suggested role name, e.g. agent-threat-modeler]`: `[Technical rationale, e.g. Model STRIDE adversaries and mitigate abuse cases]`\r\n - *(Optional)* `[Alternative role, e.g. agent-expert-user]`: `[Technical rationale, e.g. Evaluate UX and MVP boundary]`\r\n\r\n- **Suggested Invocation Prompt**:\r\n > "Act as `[next-role]` and proceed with the `[next phase]` phase on the generated deliverables: `[key artifacts]`."\r\n- **Clean Context Window Execution (Cross-IDE)**:\r\n - \u{1F9F9} **Subagent-Capable IDEs (Antigravity / Claude Code / Copilot)**: Delegate automatically via subagent tool (`invoke_subagent` / `Task` / `@agent-*`) to launch a fresh context window.\r\n - \u{1F195} **Chat-Based IDEs (Cursor / Windsurf / Aider)**: Open a **New Chat (`Cmd/Ctrl + N`)** or run `/clear` before pasting the Suggested Invocation Prompt so the next specialist starts with zero context pollution and hydrates state exclusively from `handoff.yaml` / `get_active_handoff`.\r\n\r\n- **Human Action Window (User Sovereignty and Priority)**:\r\n - \u270B **Review and Validate**: Inspect generated artifacts and validate alignment with project vision before proceeding.\r\n - \u270F\uFE0F **Edit Directly**: Modify requirements, code, or acceptance criteria directly at any time.\r\n - \u{1F6D1} **Pause, Divert, or Discard**: Freeze workflow, redirect toward another goal, or discard proposal.\r\n - \u25B6\uFE0F **Delegate to Next Agent**: If satisfied with output, execute suggested prompt to continue the chain.\r\n\r\n---\r\n';
15945
15992
  var STARTER__GITHUB_PULL_REQUEST_TEMPLATE_MD = "## 1. SDD Identification and Traceability\r\n\r\n- **SDD Change Specification**: `specs/changes/active/<change-id>/` <!-- Link to active change directory -->\r\n- **PDaC Handoff Sidecar**: `specs/changes/active/<change-id>/handoff.yaml` <!-- ID: HOF-* -->\r\n- **Git Hierarchy Tier (4 Tiers)**:\r\n - [ ] Tier 4: `task/<PARENT-ID>/<TSK-ID>-<slug>` \u2794 `feat/<PARENT-ID>-<slug>`\r\n - [ ] Tier 3: `feat/<FEAT-ID>-<slug>` \u2794 `release/vX.Y.Z`\r\n - [ ] Tier 2: `release/vX.Y.Z` \u2794 `main`\r\n- **Linked Issues**: Closes #... / Refs #...\r\n\r\n---\r\n\r\n## 2. \u{1F4CB} Plan Execution Matrix and Testing Status (`X` vs `O`)\r\n\r\n> [!IMPORTANT]\r\n> **Non-Negotiable Total Exhaustiveness Rule**:\r\n> This table must include **each and every item identified for implementation** in the delivery plan (originating from `tasks.md`, the SDD specification, or issue criteria), without omitting any or creating abstract groupings.\r\n>\r\n> **Mandatory Marking Convention**:\r\n> - **`[X]` (Completed and Tested)**: Item is 100% implemented and has verifiable automated tests on disk (`tests/` or `.feature`) passing green.\r\n> - **`[O]` (Problem / Blocked)**: If there was any issue, technical limitation, failing test, or deferred scope, it must be marked with `[O]` and **full mandatory justification is required**:\r\n> 1. **Technical root cause** or encountered limitation.\r\n> 2. **Impact** on increment or system.\r\n> 3. **Mitigation** or rationale for deferral.\r\n> 4. **Formal reference** to tracking issue (GitHub Issue or `ADR-TECH-DEBT-*`).\r\n>\r\n> *Any PR with omitted planned items or unjustified `[O]` will be immediately blocked and rejected by the Tech Lead.*\r\n\r\n| Task / Item ID | Planned Description | Status (`[X]` / `[O]`) | Test Evidence on Disk or Mandatory Justification of `[O]` |\r\n| :--- | :--- | :---: | :--- |\r\n| `TSK-001` | <!-- e.g. Contract DTOs and Interfaces Definition --> | **[X]** | Covered in `tests/unit/dto.spec.ts` (100% pass) |\r\n| `TSK-002` | <!-- e.g. Network disconnection resilience --> | **[O]** | **Root cause:** TCP socket mock exhibits race conditions in CI.<br>**Impact:** Low in prod, flaky test.<br>**Mitigation:** Temporary extended timeout; tracked in issue #... |\r\n\r\n---\r\n\r\n## 3. \u{1F5FA}\uFE0F Weak Points Map and Risk Hotspots (Weak Points Hotspots)\r\n\r\n### A. Complexity Hotspots\r\n<!-- Record functions nearing quality-policy.yaml thresholds: CC > 7 (max 10), Cognitive > 10 (max 15), LOC > 30 (max 40), MI < 70 (min 50/65) -->\r\n| File | Function / Module | Metrics (CC / Cognitive / LOC / MI) | Technical Maintainability Justification |\r\n| :--- | :--- | :---: | :--- |\r\n| <!-- e.g. src/engine.ts --> | <!-- parsePayload() --> | CC: 8, Cog: 11, LOC: 32, MI: 72 | Deterministic parser without recursion; exhaustively tested. |\r\n\r\n### B. Edge Cases and Blind Spots\r\n<!-- Scenarios not covered by automated unit tests (concurrency, network timeouts, memory, jitter) -->\r\n- [ ] **Edge Case 1**: <!-- Scenario description, estimated risk, and operational mitigation -->\r\n- [ ] **Edge Case 2**: <!-- Scenario description, estimated risk, and operational mitigation -->\r\n\r\n### C. AI Assumptions\r\n<!-- Behaviors or heuristics assumed by the agent during implementation that require critical human review -->\r\n- [ ] **Assumption 1**: <!-- e.g. Assumed payload always arrives pre-parsed in UTF-8 -->\r\n- [ ] **Assumption 2**: <!-- e.g. Default timeout set to 5000ms as not stipulated in spec -->\r\n\r\n---\r\n\r\n## 4. \u{1F6E1}\uFE0F Attack Surface and Cybersecurity (STRIDE / Zero Trust)\r\n\r\n- [ ] **New External Channels**: Does it introduce HTTP endpoints, sockets, IPC channels, or brokers?\r\n- [ ] **Sanitization and Inputs**: Are all external inputs validated with strict typing schemas (Zod/JSON Schema)?\r\n- [ ] **Insecure Serialization**: Is polymorphic deserialization or dynamic code evaluation avoided?\r\n- [ ] **Secrets and Enclaves**: Are cryptographic keys, credentials, sensitive env vars, or enclaves (`SEC-ENC-*`) handled?\r\n- [ ] **Mitigated Security Requirements**: Implemented IDs (e.g. `SEC-REQ-*`) and associated tests (`SEC-TEST-*` or `.feature`).\r\n\r\n---\r\n\r\n## 5. \u{1F4E6} Dependencies and Licenses Inspection\r\n\r\n- **New Dependencies Added**:\r\n | Package | Version | License Type | `license-policy.yaml` Verification |\r\n | :--- | :---: | :---: | :---: |\r\n | <!-- e.g. zod --> | <!-- ^3.22.4 --> | <!-- MIT --> | <!-- \u2714 Compliant (Permissive) --> |\r\n- [ ] Zero dependencies with prohibited licenses (GPLv3/AGPL/unapproved commercial).\r\n- [ ] Verification executed successfully (`pnpm run verify:licenses`).\r\n\r\n---\r\n\r\n## 6. \u2705 Deterministic Pre-Flight Checklist (Release Gates)\r\n\r\n- [ ] **Strict Typing and Linter**: `pnpm run typecheck` (zero errors, zero unjustified suppressions).\r\n- [ ] **Quality Gate**: `pnpm run verify:quality` (CC $\\le 10$, Cognitive $\\le 15$, MI $\\ge 50$, LOC $\\le 40$).\r\n- [ ] **BDD / Unit Tests**: `pnpm run verify:testing` (Gherkin scenarios synchronized and 100% passing).\r\n- [ ] **360\xB0 Traceability**: `pnpm run verify:traceability` (no orphan requirements).\r\n- [ ] **Open Source Licenses**: `pnpm run verify:licenses` (strict policy compliance).\r\n- [ ] **Schema Compliance**: `pnpm run verify:schemas` (100% of artifacts conform to JSON Schema).\r\n- [ ] **Full Test Suite**: `pnpm run test:all` / `pnpm run verify:all` (general green CI approval).\r\n\r\n---\r\n\r\n## 7. \u{1F6A8} Contingency Plan, Observability, and Rollback\r\n\r\n- **Observability Metrics and Alarms**: <!-- What metrics (p99 latency, 5xx error rate, memory) or logs should be monitored post-deployment? -->\r\n- **Rollback Procedure**: <!-- Exact command or procedure to revert change without collateral impact (e.g. git revert -m 1 <sha>) -->\r\n\r\n---\r\n\r\n## 8. \u{1F4CA} AI-SDLC: Aggregated KPIs Summary\r\n\r\n<!-- AI-SDLC-KPI-SUMMARY-START -->\r\n| Metric | Human | Total PR |\r\n| :--- | :---: | :---: |\r\n| **Commits Made** | - | **-** |\r\n| **Lines Added / Modif.** | - | **-** |\r\n| **Active Development Time** | - | **-** |\r\n| **Consumed Tokens (In+Out)** | - | **-** |\r\n| **Estimated Cost (\u20AC/$)** | \u2014 (Labor) | **-** |\r\n\r\n> *This block is updated automatically via `aisdlc kpi pr` or the CI workflow.*\r\n<!-- AI-SDLC-KPI-SUMMARY-END -->\r\n";
15946
15993
  var STARTER_COMPLIANCE_LICENSE_MANIFEST_YAML = '# ==============================================================================\r\n# AI-SDLC: Manifiesto de Cumplimiento de Licencias Evaluadas\r\n# ==============================================================================\r\n# Verificado contra: /license-policy.yaml\r\n# ==============================================================================\r\n\r\nevaluated_dependencies:\r\n - package: "@modelcontextprotocol/sdk"\r\n version: "1.0.4"\r\n spdx_license: "MIT"\r\n category: "permissive_free"\r\n status: "APPROVED"\r\n usage: "SDK oficial para servidor Model Context Protocol."\r\n commercial_payment_required: false\r\n\r\n - package: "commander"\r\n version: "12.1.0"\r\n spdx_license: "MIT"\r\n category: "permissive_free"\r\n status: "APPROVED"\r\n usage: "Parser de l\xEDnea de comandos para @ai-sdlc/cli."\r\n commercial_payment_required: false\r\n\r\n - package: "zod"\r\n version: "3.23.8"\r\n spdx_license: "MIT"\r\n category: "permissive_free"\r\n status: "APPROVED"\r\n usage: "Validaci\xF3n de esquemas y tipos en runtime."\r\n commercial_payment_required: false\r\n\r\n - package: "js-yaml"\r\n version: "4.1.0"\r\n spdx_license: "MIT"\r\n category: "permissive_free"\r\n status: "APPROVED"\r\n usage: "Parser y serializador YAML para especificaciones y frontmatter."\r\n commercial_payment_required: false\r\n\r\n - package: "chalk"\r\n version: "5.3.0"\r\n spdx_license: "MIT"\r\n category: "permissive_free"\r\n status: "APPROVED"\r\n usage: "Estilizado de salida en terminal para comandos CLI."\r\n commercial_payment_required: false\r\n\r\n - package: "ajv"\r\n version: "8.17.1"\r\n spdx_license: "MIT"\r\n category: "permissive_free"\r\n status: "APPROVED"\r\n usage: "Validador JSON Schema para ProductShape, arc42 y SDD."\r\n commercial_payment_required: false\r\n';
15947
15994
  var STARTER_PROCESS_README = "# AI-SDLC: Process & Governance Framework\n\nThis directory hosts the deterministic governance, verification gates, and lifecycle protocols for AI-assisted software development.\n\n## Core Protocols & Lifecycle\n- **Phase 0 (Product Definition)**: `specs/product/` (Requirements `FR-*`, Use Cases `UC-*`, Actors `ACT-*`, Rules `BR-*`).\n- **Phase 1 (System Architecture)**: `templates/architecture/` (arc42 + NAF v4, `CMP-*`, Decisions `ADR-*`).\n- **Phase 2 (Cybersecurity Triad)**: `templates/security/` (Threat Actors `ACT-THREAT-*`, Abuse Cases `ABUSE-*`, Security Reqs `SEC-REQ-*`).\n- **Phase 2b (Privacy-by-Design as Code)**: `templates/privacy/` (Data Assets `DATA-ASSET-*`, ROPA `PRIV-ROPA-*`, Privacy Reqs `PRIV-REQ-*`).\n- **Phase 3 (Spec-Driven Delivery - SDD)**: `specs/changes/active/<change-id>/` (`proposal.md`, `spec.md`, `design.md`, `tasks.md`, `handoff.yaml`).\n- **Phase 4 (Continuous Quality Gates & Verification)**:\n - Quality Gate: `npx aisdlc verify quality` (CC $\\le 10$, MI $\\ge 50$, LOC $\\le 40$)\n - BDD Testing: `npx aisdlc verify testing`\n - Traceability: `npx aisdlc verify traceability`\n - Licenses: `npx aisdlc verify licenses`\n - Privacy & Data Protection: `npx aisdlc verify privacy`\n - Schemas: `npx aisdlc verify schemas`\n - Release Gates: `npx aisdlc check` / `npx aisdlc verify all`\n";
@@ -16053,14 +16100,27 @@ categories:
16053
16100
  - "Unlicense"
16054
16101
  - "CC0-1.0"
16055
16102
  - "0BSD"
16103
+ - "Python-2.0"
16104
+ - "BlueOak-1.0.0"
16105
+ - "Zlib"
16106
+ - "CC-BY-3.0"
16107
+ - "CC-BY-4.0"
16108
+ - "MS-PL"
16056
16109
 
16057
16110
  weak_copyleft_conditional:
16058
16111
  action: "REVIEW_REQUIRED"
16059
16112
  description: "Allowed only as dynamically linked decoupled libraries."
16060
16113
  spdx_identifiers:
16061
16114
  - "LGPL-2.1-only"
16115
+ - "LGPL-2.1-or-later"
16062
16116
  - "LGPL-3.0-only"
16117
+ - "LGPL-3.0-or-later"
16063
16118
  - "MPL-2.0"
16119
+ - "EPL-2.0"
16120
+ - "CDDL-1.0"
16121
+ - "MS-RL"
16122
+ - "MS-LPL"
16123
+ - "MS-LRL"
16064
16124
 
16065
16125
  strong_copyleft_viral:
16066
16126
  action: "DENY"
@@ -16190,6 +16250,9 @@ var STARTER_WORKFLOW_HANDOFF_TEMPLATE = `# Workflow Handoff Template
16190
16250
 
16191
16251
  - **Suggested Invocation Prompt**:
16192
16252
  > "Act as \`[next-role]\` and proceed with the \`[next phase]\` phase on the generated deliverables: \`[key artifacts]\`."
16253
+ - **Clean Context Window Execution (Cross-IDE)**:
16254
+ - \u{1F9F9} **Subagent-Capable IDEs (Antigravity / Claude Code / Copilot)**: Delegate automatically via subagent tool (\`invoke_subagent\` / \`Task\` / \`@agent-*\`) to launch a fresh context window.
16255
+ - \u{1F195} **Chat-Based IDEs (Cursor / Windsurf / Aider)**: Open a **New Chat (\`Cmd/Ctrl + N\`)** or run \`/clear\` before pasting the Suggested Invocation Prompt so the next specialist starts with zero context pollution and hydrates state exclusively from \`handoff.yaml\` / \`get_active_handoff\`.
16193
16256
 
16194
16257
  - **Human Action Window (User Sovereignty and Priority)**:
16195
16258
  - \u270B **Review and Validate**: Inspect generated artifacts and validate alignment with project vision before proceeding.