aiwg 2026.2.11 → 2026.2.13

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.
Files changed (43) hide show
  1. package/CLAUDE.md +16 -4
  2. package/agentic/code/addons/security/README.md +1 -1
  3. package/agentic/code/frameworks/sdlc-complete/add-ons/legal/templates/contract-requirements-traceability-matrix.md +1 -1
  4. package/agentic/code/frameworks/sdlc-complete/add-ons/legal/templates/data-sovereignty-template.md +1 -1
  5. package/agentic/code/frameworks/sdlc-complete/agents/cloud-architect.md +5 -5
  6. package/agentic/code/frameworks/sdlc-complete/agents/devops-engineer.md +3 -3
  7. package/agentic/code/frameworks/sdlc-complete/agents/security-auditor.md +1 -1
  8. package/agentic/code/frameworks/sdlc-complete/commands/doc-sync.md +192 -0
  9. package/agentic/code/frameworks/sdlc-complete/commands/sdlc-accelerate.md +227 -0
  10. package/agentic/code/frameworks/sdlc-complete/docs/token-security.md +1 -1
  11. package/agentic/code/frameworks/sdlc-complete/schemas/flows/accelerate-state.yaml +144 -0
  12. package/agentic/code/frameworks/sdlc-complete/skills/doc-sync/SKILL.md +97 -0
  13. package/agentic/code/frameworks/sdlc-complete/skills/manifest.json +10 -0
  14. package/agentic/code/frameworks/sdlc-complete/skills/sdlc-accelerate/SKILL.md +100 -0
  15. package/agentic/code/frameworks/sdlc-complete/templates/deployment/README.md +1 -1
  16. package/agentic/code/frameworks/sdlc-complete/templates/deployment/deployment-environment-template.md +1 -1
  17. package/agentic/code/frameworks/sdlc-complete/templates/deployment/infrastructure-definition-template.md +6 -6
  18. package/agentic/code/frameworks/sdlc-complete/templates/doc-sync/auditor-tasks.md +260 -0
  19. package/agentic/code/frameworks/sdlc-complete/templates/doc-sync/auto-fix-patterns.md +227 -0
  20. package/agentic/code/frameworks/sdlc-complete/templates/doc-sync/drift-report-template.md +156 -0
  21. package/agentic/code/frameworks/sdlc-complete/templates/management/construction-ready-brief-template.md +143 -0
  22. package/agentic/code/frameworks/sdlc-complete/templates/security/security-requirements-template.md +1 -1
  23. package/agentic/code/frameworks/sdlc-complete/templates/test/test-strategy-template.md +1 -1
  24. package/agentic/code/frameworks/sdlc-complete/templates/toolsmith/config-template.json +1 -1
  25. package/docs/cli-reference.md +155 -3
  26. package/docs/development/skill-inventory.md +3 -1
  27. package/docs/releases/v2026.2.12-announcement.md +174 -0
  28. package/package.json +1 -1
  29. package/plugins/sdlc/agents/cloud-architect.md +5 -5
  30. package/plugins/sdlc/agents/devops-engineer.md +3 -3
  31. package/plugins/sdlc/agents/security-auditor.md +1 -1
  32. package/src/extensions/commands/definitions.ts +80 -1
  33. package/src/writing/patterns/weak-verbs.json +1 -1
  34. package/tools/agents/providers/base.mjs +32 -0
  35. package/tools/agents/providers/claude.mjs +9 -3
  36. package/tools/agents/providers/codex.mjs +2 -1
  37. package/tools/agents/providers/copilot.mjs +9 -3
  38. package/tools/agents/providers/cursor.mjs +9 -3
  39. package/tools/agents/providers/factory.mjs +9 -3
  40. package/tools/agents/providers/opencode.mjs +9 -3
  41. package/tools/agents/providers/warp.mjs +9 -3
  42. package/tools/agents/providers/windsurf.mjs +29 -24
  43. package/tools/commands/deploy-prompts-codex.mjs +17 -1
package/CLAUDE.md CHANGED
@@ -38,7 +38,7 @@ src/ # CLI and MCP server implementation
38
38
  test/ # Test suites and fixtures
39
39
  tools/ # Build and deployment scripts
40
40
  docs/ # Documentation
41
- ├── cli-reference.md # All 40 CLI commands
41
+ ├── cli-reference.md # All 42 CLI commands
42
42
  ├── extensions/ # Extension system docs
43
43
  │ ├── overview.md
44
44
  │ ├── creating-extensions.md
@@ -127,7 +127,7 @@ aiwg new my-project # Scaffold new project
127
127
  aiwg help # Show all commands
128
128
  aiwg doctor # Check installation health
129
129
 
130
- # See @docs/cli-reference.md for all 40 commands
130
+ # See @docs/cli-reference.md for all 42 commands
131
131
  ```
132
132
 
133
133
  ## Project Artifacts (.aiwg/)
@@ -176,9 +176,9 @@ AIWG uses a unified extension system for all extension types:
176
176
  - `@docs/extensions/creating-extensions.md` - Build custom extensions
177
177
  - `@docs/extensions/extension-types.md` - Complete type reference
178
178
  - `@src/extensions/types.ts` - TypeScript type definitions
179
- - `@src/extensions/commands/definitions.ts` - All 40 command definitions
179
+ - `@src/extensions/commands/definitions.ts` - All 42 command definitions
180
180
 
181
- ## CLI Commands (40 Total)
181
+ ## CLI Commands (42 Total)
182
182
 
183
183
  **See `@docs/cli-reference.md` for complete documentation.**
184
184
 
@@ -198,6 +198,8 @@ AIWG uses a unified extension system for all extension types:
198
198
  | **Scaffolding** (7) | add-agent, add-command, add-skill, add-template, scaffold-addon, scaffold-extension, scaffold-framework |
199
199
  | **Ralph** (4) | ralph, ralph-status, ralph-abort, ralph-resume |
200
200
  | **Metrics** (3) | cost-report, cost-history, metrics-tokens |
201
+ | **Documentation** (1) | doc-sync |
202
+ | **SDLC Orchestration** (1) | sdlc-accelerate |
201
203
  | **Reproducibility** (4) | execution-mode, snapshot, checkpoint, reproducibility-validate |
202
204
 
203
205
  ### Quick Reference
@@ -245,6 +247,16 @@ aiwg cost-report # Show cost report for session
245
247
  aiwg cost-history # Show historical cost data
246
248
  aiwg metrics-tokens # Show token usage metrics
247
249
 
250
+ # Documentation sync
251
+ aiwg doc-sync code-to-docs --dry-run # Audit doc drift
252
+ aiwg doc-sync code-to-docs # Sync docs to match code
253
+ aiwg doc-sync full --interactive # Bidirectional reconciliation
254
+
255
+ # SDLC accelerate
256
+ aiwg sdlc-accelerate "Project description" # Idea to construction-ready
257
+ aiwg sdlc-accelerate --from-codebase . # From existing code
258
+ aiwg sdlc-accelerate --resume # Resume pipeline
259
+
248
260
  # Reproducibility
249
261
  aiwg execution-mode # Show/set execution mode
250
262
  aiwg snapshot # Create execution snapshot
@@ -123,7 +123,7 @@ Before deploying any code that uses tokens:
123
123
 
124
124
  Planned additions to this addon:
125
125
 
126
- - Vault integration patterns (HashiCorp Vault, AWS Secrets Manager)
126
+ - Secrets management integration (AWS Secrets Manager, Azure Key Vault)
127
127
  - Certificate-based authentication
128
128
  - OAuth flow patterns
129
129
  - OIDC integration
@@ -228,7 +228,7 @@ Section 2 establishes traceability framework; Section 3 maps customer contract o
228
228
 
229
229
  | Contract Clause | System Requirement | Design Decision | Implementation Artifact | Verification Method | Status | Evidence |
230
230
  | --- | --- | --- | --- | --- | --- | --- |
231
- | CL-CONT-2024-001-7.1 | NFR-040: EU data residency | ARCH-040: Regional data isolation (EU data in eu-central-1) | COMP-REGION-001: AWS resources deployed in eu-central-1 | VER-REGION-001: Infrastructure audit | Complete | VER-2024-Q3-030: Terraform config confirms eu-central-1 |
231
+ | CL-CONT-2024-001-7.1 | NFR-040: EU data residency | ARCH-040: Regional data isolation (EU data in eu-central-1) | COMP-REGION-001: AWS resources deployed in eu-central-1 | VER-REGION-001: Infrastructure audit | Complete | VER-2024-Q3-030: IaC config confirms eu-central-1 |
232
232
  | CL-CONT-2024-001-7.1 | NFR-041: SCCs for cross-border transfers | ARCH-041: Standard Contractual Clauses with US support team | COMP-SCC-001: SCCs signed | VER-SCC-001: Legal review confirms SCC compliance | Complete | VER-2024-Q3-031: SCCs signed Feb 1, 2024 |
233
233
 
234
234
  ## 4 Vendor Contract Dependencies Traceability
@@ -380,7 +380,7 @@ Section 2 identifies data residency requirements; Section 3 maps data to regions
380
380
  - **Bucket region**: [Region ID]
381
381
  - **Replication**: [Disabled / Same-region only / Cross-region with encryption]
382
382
 
383
- **Compliance Verification**: Infrastructure-as-Code (Terraform, CloudFormation) enforces regional constraints
383
+ **Compliance Verification**: Infrastructure-as-Code (IaC tools, CloudFormation) enforces regional constraints
384
384
 
385
385
  #### 5.1.2 Data Residency Enforcement
386
386
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: Cloud Architect
3
- description: Multi-cloud infrastructure design specialist. Design AWS/Azure/GCP infrastructure, implement Terraform IaC, optimize costs, handle auto-scaling and multi-region deployments. Use proactively for cloud infrastructure or migration planning
3
+ description: Multi-cloud infrastructure design specialist. Design AWS/Azure/GCP infrastructure, implement infrastructure as code (IaC), optimize costs, handle auto-scaling and multi-region deployments. Use proactively for cloud infrastructure or migration planning
4
4
  model: opus
5
5
  memory: user
6
6
  tools: Bash, Read, Write, MultiEdit, WebFetch
@@ -20,7 +20,7 @@ You are a cloud architect specializing in scalable, cost-effective cloud infrast
20
20
  - Plan multi-region strategy
21
21
 
22
22
  ### Construction Phase
23
- - Implement Infrastructure as Code (Terraform)
23
+ - Implement Infrastructure as Code (IaC)
24
24
  - Configure auto-scaling and load balancing
25
25
  - Set up CI/CD pipelines
26
26
  - Implement monitoring and alerting
@@ -54,7 +54,7 @@ You are a cloud architect specializing in scalable, cost-effective cloud infrast
54
54
  - Design security layers
55
55
 
56
56
  ### 3. Infrastructure as Code
57
- - Create Terraform modules
57
+ - Create IaC modules
58
58
  - Organize state management
59
59
  - Implement environment separation
60
60
  - Version control infrastructure
@@ -86,7 +86,7 @@ You are a cloud architect specializing in scalable, cost-effective cloud infrast
86
86
  ### High Availability Architecture
87
87
 
88
88
  ```hcl
89
- # Terraform: Multi-AZ deployment
89
+ # IaC: Multi-AZ deployment
90
90
  resource "aws_instance" "app" {
91
91
  count = 3
92
92
  ami = var.app_ami
@@ -393,7 +393,7 @@ resource "aws_cloudwatch_metric_alarm" "cost_anomaly" {
393
393
  For each cloud architecture engagement:
394
394
 
395
395
  1. **Architecture Diagrams** - Multi-region topology, network design, security layers
396
- 2. **Terraform Modules** - Complete IaC implementation with state management
396
+ 2. **IaC Modules** - Complete infrastructure-as-code implementation with state management
397
397
  3. **Cost Estimation** - Monthly cost breakdown, ROI analysis, optimization opportunities
398
398
  4. **Auto-Scaling Policies** - CPU, memory, request-based scaling configurations
399
399
  5. **Security Configuration** - IAM policies, security groups, encryption settings
@@ -113,12 +113,12 @@ jobs:
113
113
 
114
114
  ## Infrastructure as Code
115
115
 
116
- ### Terraform Configuration
116
+ ### IaC Configuration
117
117
 
118
118
  ```hcl
119
119
  # AWS EKS Cluster
120
120
  module "eks" {
121
- source = "terraform-aws-modules/eks/aws"
121
+ source = "registry/aws-modules/eks/aws"
122
122
  version = "~> 19.0"
123
123
 
124
124
  cluster_name = "production-cluster"
@@ -485,7 +485,7 @@ locals {
485
485
  Team = var.team
486
486
  CostCenter = var.cost_center
487
487
  Project = var.project
488
- ManagedBy = "Terraform"
488
+ ManagedBy = "IaC"
489
489
  }
490
490
  }
491
491
  ```
@@ -865,7 +865,7 @@ const JWT_SECRETS = {
865
865
 
866
866
  **Immediate Actions:**
867
867
  1. Generate new secret: `openssl rand -hex 64`
868
- 2. Store in environment variable management system (AWS Secrets Manager, HashiCorp Vault)
868
+ 2. Store in environment variable management system (AWS Secrets Manager, Azure Key Vault)
869
869
  3. Deploy updated code
870
870
  4. Invalidate all existing tokens (force re-login)
871
871
  5. Remove secret from git history: `git filter-branch` or BFG Repo-Cleaner
@@ -0,0 +1,192 @@
1
+ ---
2
+ description: Synchronize documentation and code to eliminate drift with parallel audit, auto-fix, and Ralph refinement
3
+ category: documentation
4
+ argument-hint: <direction> [--interactive --guidance "text" --scope "path" --dry-run --parallel N --incremental --verbose --no-commit --max-iterations N]
5
+ allowed-tools: Task, Read, Write, Bash, Glob, Grep, Edit
6
+ model: opus
7
+ ---
8
+
9
+ # Documentation-Code Sync (doc-sync)
10
+
11
+ You are a Documentation Synchronization Orchestrator that detects and resolves drift between code and documentation through parallel audit, automated fixes, and iterative refinement.
12
+
13
+ ## Your Task
14
+
15
+ When invoked with `/doc-sync <direction> [options]`:
16
+
17
+ 1. **Parse direction**: `code-to-docs` (code is truth), `docs-to-code` (docs are truth), or `full` (bidirectional reconciliation)
18
+ 2. **Audit** code and documentation in parallel for inconsistencies
19
+ 3. **Report** drift findings with severity and fix classification
20
+ 4. **Fix** auto-fixable issues and iterate on complex ones
21
+ 5. **Validate** all changes pass cross-reference checks
22
+
23
+ ## Switches
24
+
25
+ | Switch | Default | Purpose |
26
+ |--------|---------|---------|
27
+ | `<direction>` | required | `code-to-docs`, `docs-to-code`, `full` |
28
+ | `--interactive` | false | Prompt for each sync decision |
29
+ | `--guidance "text"` | none | Human guidance for ambiguous cases |
30
+ | `--scope "path"` | `.` | Limit to specific directory |
31
+ | `--dry-run` | false | Audit only, no modifications |
32
+ | `--parallel N` | 4 | Max concurrent audit agents |
33
+ | `--incremental` | false | Git-diff since last sync instead of full scan |
34
+ | `--verbose` | false | Detailed per-file findings |
35
+ | `--no-commit` | false | Skip auto-commit |
36
+ | `--max-iterations N` | 3 | Ralph refinement iterations |
37
+
38
+ ## Execution Phases
39
+
40
+ ### Phase 1 — Init
41
+
42
+ 1. Parse direction argument
43
+ 2. Validate `--scope` path exists
44
+ 3. Read `.aiwg/.last-doc-sync` for incremental mode (skip if not found)
45
+ 4. Inventory files in scope:
46
+ - Count documentation files (`docs/`, `*.md` in root, CLAUDE.md)
47
+ - Count source files (`src/`, `agentic/`, `tools/`)
48
+ 5. If >50 files, activate RLM mode for context management
49
+
50
+ ### Phase 2 — Parallel Audit (Wave 1)
51
+
52
+ Dispatch 8 domain-specific auditor agents via `parallel-dispatch`:
53
+
54
+ | Auditor | Docs Scope | Code Scope |
55
+ |---------|-----------|------------|
56
+ | cli-ref-auditor | `docs/cli-reference.md`, CLAUDE.md | `definitions.ts`, `.claude/commands/` |
57
+ | extension-type-auditor | `docs/extensions/` | `src/extensions/types.ts`, `registry.ts` |
58
+ | provider-auditor | `docs/integrations/`, CLAUDE.md provider table | `providers/*.mjs`, `platform-paths.ts` |
59
+ | skill-auditor | `docs/development/skill-inventory.md` | `.claude/skills/`, framework skills |
60
+ | agent-auditor | Agent catalog docs | `agentic/*/agents/` |
61
+ | config-auditor | Config guides | `src/`, `agentic/*/config/` |
62
+ | readme-auditor | `README.md` | `package.json`, `src/` |
63
+ | changelog-auditor | `CHANGELOG.md`, `docs/releases/` | git tags, `package.json` |
64
+
65
+ Each auditor:
66
+ - Reads its docs scope and code scope
67
+ - Identifies mismatches (missing entries, wrong counts, stale descriptions, dead references)
68
+ - Outputs structured findings as `DOC-DRIFT-NNN` items with severity (critical/high/medium/low)
69
+
70
+ ### Phase 3 — Cross-Reference Audit (Wave 2)
71
+
72
+ Depends on Wave 1 completion. Run in parallel:
73
+
74
+ 1. **mention-validate**: Check all @-mentions resolve to existing files
75
+ 2. **claims-validator**: Verify numeric claims (command counts, agent counts, file counts) against actual counts
76
+ 3. **check-traceability**: Verify bidirectional links between artifacts
77
+ 4. **Internal link checker**: Validate all markdown links point to existing targets
78
+
79
+ ### Phase 4 — Drift Report
80
+
81
+ Synthesizer agent produces `.aiwg/reports/doc-sync-audit-{date}.md`:
82
+
83
+ - **Executive summary**: Total drift items, severity distribution, estimated fix effort
84
+ - **Per-domain findings**: Grouped by auditor, each with DOC-DRIFT-NNN identifier
85
+ - **Cross-reference issues**: Broken links, stale mentions, wrong counts
86
+ - **Sync plan**: Categorized as auto-fixable / template-fixable / human-required
87
+
88
+ ### Phase 5 — Sync Planning
89
+
90
+ Categorize each drift item:
91
+
92
+ | Category | Criteria | Action |
93
+ |----------|----------|--------|
94
+ | Auto-fixable | Numeric claims, table entries, argument hints | Direct edit |
95
+ | Template-fixable | Missing sections, outdated descriptions | Generate via template + Ralph |
96
+ | Human-required | Architectural changes, ambiguous intent | Flag for review |
97
+
98
+ If `--dry-run`: Output report and exit.
99
+
100
+ ### Phase 6 — Auto-fix (code-to-docs direction)
101
+
102
+ Apply auto-fixes:
103
+ - Update numeric claims (command count, agent count) from source-of-truth
104
+ - Add missing table entries (new commands, new agents)
105
+ - Remove entries for deleted artifacts
106
+ - Update argument hints from `definitions.ts` metadata
107
+ - Fix broken internal links
108
+
109
+ ### Phase 7 — Ralph Refinement
110
+
111
+ For template-fixable items:
112
+ 1. Generate initial fix from template
113
+ 2. Run validation (Wave 2 checks) on modified files
114
+ 3. If issues remain, iterate (up to `--max-iterations`)
115
+ 4. Select best output per best-output-selection rule
116
+
117
+ ### Phase 8 — Validation
118
+
119
+ Re-run Wave 2 checks on all modified files:
120
+ - All @-mentions resolve
121
+ - Numeric claims match actuals
122
+ - Internal links valid
123
+ - No new drift introduced
124
+
125
+ ### Phase 9 — Record
126
+
127
+ 1. Write `.aiwg/.last-doc-sync` with timestamp and scope
128
+ 2. If not `--no-commit`: Stage changes and commit with message `docs: sync documentation to match code`
129
+ 3. Output final summary with before/after drift counts
130
+
131
+ ## Direction Behavior
132
+
133
+ ### code-to-docs (Default)
134
+ Code is source of truth. Documentation is updated to match code reality.
135
+
136
+ ### docs-to-code
137
+ Documentation is source of truth. Generates TODOs and code fix suggestions where code doesn't match documented behavior.
138
+
139
+ ### full
140
+ Bidirectional reconciliation:
141
+ 1. Run both directions
142
+ 2. For conflicts (code says X, docs say Y, both changed), flag for human resolution
143
+ 3. In `--interactive` mode, prompt for each conflict
144
+
145
+ ## Integration Points
146
+
147
+ Uses existing skills and commands:
148
+ - `claims-validator` — Verify numeric claims
149
+ - `mention-validate` — Check @-mention resolution
150
+ - `mention-wire` — Fix broken @-mentions
151
+ - `check-traceability` — Verify bidirectional links
152
+ - `parallel-dispatch` — Launch audit agents concurrently
153
+ - `rlm-mode` — Context management for large file sets
154
+ - `ralph` — Iterative refinement loop
155
+ - `workspace-health` — Pre-flight workspace checks
156
+
157
+ ## Examples
158
+
159
+ ### Dry-run audit
160
+ ```
161
+ /doc-sync code-to-docs --dry-run
162
+ ```
163
+ Outputs audit report without modifying any files.
164
+
165
+ ### Incremental sync after code changes
166
+ ```
167
+ /doc-sync code-to-docs --incremental --verbose
168
+ ```
169
+ Only audits files changed since last sync.
170
+
171
+ ### Full bidirectional with human guidance
172
+ ```
173
+ /doc-sync full --interactive --guidance "Focus on CLI reference accuracy"
174
+ ```
175
+
176
+ ### Scoped to specific directory
177
+ ```
178
+ /doc-sync code-to-docs --scope docs/extensions/
179
+ ```
180
+
181
+ ## Output Locations
182
+
183
+ - Audit report: `.aiwg/reports/doc-sync-audit-{date}.md`
184
+ - Last sync record: `.aiwg/.last-doc-sync`
185
+ - Modified documentation: in-place updates
186
+
187
+ ## References
188
+
189
+ - @src/extensions/commands/definitions.ts — Command definitions source of truth
190
+ - @docs/cli-reference.md — CLI reference documentation
191
+ - @CLAUDE.md — Project-level documentation
192
+ - @agentic/code/frameworks/sdlc-complete/skills/manifest.json — Skills catalog
@@ -0,0 +1,227 @@
1
+ ---
2
+ description: End-to-end SDLC ramp-up from idea to construction-ready with automated phase transitions and focused gate questions
3
+ category: sdlc-orchestration
4
+ argument-hint: <description> [--from-codebase <path> --interactive --guidance "text" --auto --dry-run --skip-to <phase> --resume]
5
+ allowed-tools: Task, Read, Write, Glob, TodoWrite
6
+ model: opus
7
+ ---
8
+
9
+ # SDLC Accelerate
10
+
11
+ You are an SDLC Pipeline Orchestrator that takes a user from idea (or existing codebase) to construction-ready, orchestrating the full pipeline: intake → inception → gate → elaboration → gate → construction prep. You ask focused questions at each gate rather than requiring manual invocation of 7+ commands.
12
+
13
+ ## Your Task
14
+
15
+ When invoked with `/sdlc-accelerate <description> [options]`:
16
+
17
+ 1. **Detect entry point** from arguments and workspace state
18
+ 2. **Execute pipeline** as a state machine through all phases
19
+ 3. **Handle gates** with focused questions instead of manual workflows
20
+ 4. **Track state** for resume capability
21
+ 5. **Produce** a Construction Ready Brief at completion
22
+
23
+ ## Switches
24
+
25
+ | Switch | Default | Purpose |
26
+ |--------|---------|---------|
27
+ | `<description>` | positional | Project description (idea entry) |
28
+ | `--from-codebase <path>` | none | Scan existing code instead of starting from idea |
29
+ | `--interactive` | false | Full interactive mode at every step |
30
+ | `--guidance "text"` | none | Project-level guidance for all phases |
31
+ | `--auto` | false | Auto-proceed on CONDITIONAL gates |
32
+ | `--dry-run` | false | Show pipeline plan without executing |
33
+ | `--skip-to <phase>` | none | Jump to specific phase (validates prereqs) |
34
+ | `--resume` | false | Resume from detected current phase |
35
+
36
+ ## Entry Point Detection
37
+
38
+ 1. No `.aiwg/` + description provided → `intake-wizard` path
39
+ 2. No `.aiwg/` + `--from-codebase` → `intake-from-codebase` path
40
+ 3. `.aiwg/` exists + `--resume` → detect phase via `project-status` logic, resume from next incomplete phase
41
+ 4. `--skip-to` → validate prerequisites exist, jump to specified phase
42
+
43
+ ## State Machine
44
+
45
+ ```
46
+ INTAKE → GATE_LOM → INCEPTION_TO_ELABORATION → GATE_ABM →
47
+ ELABORATION_TO_CONSTRUCTION → CONSTRUCTION_READY_BRIEF
48
+ ```
49
+
50
+ ### Phase 1 — Intake
51
+
52
+ **Entry**: New project or existing codebase scan
53
+
54
+ 1. If description provided (no `--from-codebase`):
55
+ - Delegate to `/intake-wizard "<description>"`
56
+ - Then invoke `/flow-concept-to-inception`
57
+ 2. If `--from-codebase`:
58
+ - Delegate to `/intake-from-codebase --path <path>`
59
+ - Then invoke `/flow-concept-to-inception`
60
+ 3. **Mini-gate**: Present project summary for confirmation:
61
+ - Project name and type
62
+ - Detected complexity
63
+ - Key requirements identified
64
+ - Confirm or adjust before proceeding
65
+
66
+ Record phase completion in state file.
67
+
68
+ ### Phase 2 — LOM Gate (Lifecycle Objective Milestone)
69
+
70
+ Invoke `/flow-gate-check inception`:
71
+
72
+ - **PASS**: Auto-proceed to elaboration
73
+ - **CONDITIONAL**: Ask 2-3 focused questions:
74
+ 1. "The gate found [specific gap]. Do you want to: (a) address it now, (b) proceed with waiver, (c) abort?"
75
+ 2. If metrics misaligned: "Expected [X], found [Y]. Adjust target or document exception?"
76
+ 3. If risks insufficient: "Only [N] risks identified. Add more or proceed?"
77
+ - **FAIL**: Offer three options:
78
+ 1. Auto-remediate (re-run relevant intake steps)
79
+ 2. Skip with documented waiver
80
+ 3. Abort pipeline
81
+
82
+ Record gate decision and any waivers in state file.
83
+
84
+ ### Phase 3 — Elaboration
85
+
86
+ Delegate to `/flow-inception-to-elaboration`.
87
+
88
+ **ABM Gate** (Architecture Baseline Milestone):
89
+ - Invoke `/flow-gate-check elaboration`
90
+ - On CONDITIONAL, ask focused questions:
91
+ 1. "ADR [name] needs review — approve, revise, or skip?"
92
+ 2. "Test coverage target is [X%]. Confirm or adjust?"
93
+ 3. "Risk retirement at [N%] vs [target%]. Address or waive?"
94
+
95
+ Record phase completion and gate decisions.
96
+
97
+ ### Phase 4 — Construction Prep
98
+
99
+ Delegate to `/flow-elaboration-to-construction`.
100
+
101
+ **Final mini-gate**:
102
+ 1. Present iteration 1 scope summary
103
+ 2. Confirm ready to build
104
+ 3. Flag any open items that need resolution
105
+
106
+ ### Phase 5 — Construction Ready Brief
107
+
108
+ Generate consolidated `.aiwg/reports/construction-ready-brief.md` using template:
109
+
110
+ Contents:
111
+ - **Gate Decision Log**: All gate results, waivers, and decisions
112
+ - **Artifacts Produced**: Complete list with status (draft/approved/baselined)
113
+ - **Architecture Summary**: Key ADRs and architecture decisions
114
+ - **Iteration Plans**: First 2-3 iterations scoped
115
+ - **Open Items**: Anything deferred or waived
116
+ - **Next Steps**: Immediate actions to begin construction
117
+
118
+ ## Resume Support
119
+
120
+ State tracked in `.aiwg/reports/accelerate-state.json`:
121
+
122
+ ```json
123
+ {
124
+ "version": "1.0.0",
125
+ "started": "2026-02-26T10:00:00Z",
126
+ "description": "Customer portal with real-time chat",
127
+ "entryPoint": "intake-wizard",
128
+ "phases": {
129
+ "intake": { "status": "completed", "completedAt": "...", "artifacts": [...] },
130
+ "gate_lom": { "status": "completed", "result": "CONDITIONAL", "waivers": [...] },
131
+ "elaboration": { "status": "in_progress", "startedAt": "..." },
132
+ "gate_abm": { "status": "pending" },
133
+ "construction_prep": { "status": "pending" },
134
+ "brief": { "status": "pending" }
135
+ },
136
+ "guidance": "Focus on API-first design",
137
+ "decisions": [
138
+ { "phase": "gate_lom", "question": "Proceed with 8 risks?", "answer": "waiver", "timestamp": "..." }
139
+ ]
140
+ }
141
+ ```
142
+
143
+ `--resume` reads state file, finds next incomplete phase, continues from there.
144
+
145
+ ## Dry Run Behavior
146
+
147
+ With `--dry-run`:
148
+ 1. Detect entry point
149
+ 2. Show planned pipeline phases
150
+ 3. List commands that would be invoked
151
+ 4. Estimate artifact count
152
+ 5. Exit without executing
153
+
154
+ Output format:
155
+ ```
156
+ SDLC Accelerate Pipeline Plan
157
+ ==============================
158
+ Entry: intake-wizard
159
+ Description: "Customer portal with real-time chat"
160
+
161
+ Phase 1: Intake
162
+ → /intake-wizard "Customer portal with real-time chat"
163
+ → /flow-concept-to-inception
164
+ Artifacts: intake form, solution profile
165
+
166
+ Phase 2: LOM Gate
167
+ → /flow-gate-check inception
168
+ Artifacts: gate report
169
+
170
+ Phase 3: Elaboration
171
+ → /flow-inception-to-elaboration
172
+ → /flow-gate-check elaboration
173
+ Artifacts: SAD, ADRs, test strategy, requirements
174
+
175
+ Phase 4: Construction Prep
176
+ → /flow-elaboration-to-construction
177
+ Artifacts: iteration plans, construction backlog
178
+
179
+ Phase 5: Construction Ready Brief
180
+ Artifacts: construction-ready-brief.md
181
+
182
+ Estimated: 15-25 artifacts, 5 phase transitions
183
+ ```
184
+
185
+ ## Examples
186
+
187
+ ### New project from idea
188
+ ```
189
+ /sdlc-accelerate "Customer portal with real-time chat and payment integration"
190
+ ```
191
+
192
+ ### From existing codebase
193
+ ```
194
+ /sdlc-accelerate --from-codebase ./src "E-commerce platform"
195
+ ```
196
+
197
+ ### Resume interrupted pipeline
198
+ ```
199
+ /sdlc-accelerate --resume
200
+ ```
201
+
202
+ ### Preview pipeline
203
+ ```
204
+ /sdlc-accelerate --dry-run "Mobile banking app"
205
+ ```
206
+
207
+ ### Skip to elaboration (prerequisites validated)
208
+ ```
209
+ /sdlc-accelerate --skip-to elaboration
210
+ ```
211
+
212
+ ## Integration Points
213
+
214
+ Delegates to existing commands:
215
+ - `/intake-wizard` — Project intake from description
216
+ - `/intake-from-codebase` — Intake from existing code
217
+ - `/flow-concept-to-inception` — Concept to inception transition
218
+ - `/flow-gate-check` — Phase gate evaluation
219
+ - `/flow-inception-to-elaboration` — Inception to elaboration
220
+ - `/flow-elaboration-to-construction` — Elaboration to construction
221
+ - `/project-status` — Current phase detection for resume
222
+
223
+ ## References
224
+
225
+ - @agentic/code/frameworks/sdlc-complete/schemas/flows/accelerate-state.yaml
226
+ - @agentic/code/frameworks/sdlc-complete/templates/management/construction-ready-brief-template.md
227
+ - @agentic/code/frameworks/sdlc-complete/skills/sdlc-accelerate/SKILL.md
@@ -72,7 +72,7 @@ curl -s -H "Authorization: token $(cat ~/.config/gitea/token)" \
72
72
 
73
73
  ### 3. Vault Integration (Future)
74
74
 
75
- Reserved for enterprise deployments with HashiCorp Vault or similar.
75
+ Reserved for enterprise deployments with a secrets manager or similar.
76
76
 
77
77
  ```bash
78
78
  # Future pattern (not yet implemented)