aiwg 2026.2.10 → 2026.2.12
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/CLAUDE.md +19 -7
- package/agentic/code/addons/security/README.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/add-ons/legal/templates/contract-requirements-traceability-matrix.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/add-ons/legal/templates/data-sovereignty-template.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/agents/cloud-architect.md +5 -5
- package/agentic/code/frameworks/sdlc-complete/agents/devops-engineer.md +3 -3
- package/agentic/code/frameworks/sdlc-complete/agents/security-auditor.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/commands/doc-sync.md +192 -0
- package/agentic/code/frameworks/sdlc-complete/commands/sdlc-accelerate.md +227 -0
- package/agentic/code/frameworks/sdlc-complete/docs/token-security.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/schemas/flows/accelerate-state.yaml +144 -0
- package/agentic/code/frameworks/sdlc-complete/skills/doc-sync/SKILL.md +97 -0
- package/agentic/code/frameworks/sdlc-complete/skills/issue-driven-ralph/SKILL.md +5 -0
- package/agentic/code/frameworks/sdlc-complete/skills/manifest.json +10 -0
- package/agentic/code/frameworks/sdlc-complete/skills/sdlc-accelerate/SKILL.md +100 -0
- package/agentic/code/frameworks/sdlc-complete/templates/deployment/README.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/templates/deployment/deployment-environment-template.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/templates/deployment/infrastructure-definition-template.md +6 -6
- package/agentic/code/frameworks/sdlc-complete/templates/doc-sync/auditor-tasks.md +260 -0
- package/agentic/code/frameworks/sdlc-complete/templates/doc-sync/auto-fix-patterns.md +227 -0
- package/agentic/code/frameworks/sdlc-complete/templates/doc-sync/drift-report-template.md +156 -0
- package/agentic/code/frameworks/sdlc-complete/templates/management/construction-ready-brief-template.md +143 -0
- package/agentic/code/frameworks/sdlc-complete/templates/security/security-requirements-template.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/templates/test/test-strategy-template.md +1 -1
- package/agentic/code/frameworks/sdlc-complete/templates/toolsmith/config-template.json +1 -1
- package/docs/cli-reference.md +155 -3
- package/docs/contributing/versioning.md +6 -1
- package/docs/development/skill-inventory.md +3 -1
- package/docs/releases/v2026.2.12-announcement.md +174 -0
- package/package.json +1 -1
- package/plugins/sdlc/agents/cloud-architect.md +5 -5
- package/plugins/sdlc/agents/devops-engineer.md +3 -3
- package/plugins/sdlc/agents/security-auditor.md +1 -1
- package/src/extensions/commands/definitions.ts +80 -1
- package/src/writing/patterns/weak-verbs.json +1 -1
- package/tools/skills/deploy-skills-codex.mjs +29 -4
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
|
|
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
|
|
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
|
|
179
|
+
- `@src/extensions/commands/definitions.ts` - All 42 command definitions
|
|
180
180
|
|
|
181
|
-
## CLI Commands (
|
|
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
|
|
@@ -450,9 +462,9 @@ Before pushing a version tag:
|
|
|
450
462
|
- Migration notes (if applicable)
|
|
451
463
|
- Links to relevant documentation
|
|
452
464
|
4. **Commit and tag** - `git tag -m "vX.X.X" vX.X.X`
|
|
453
|
-
5. **Push to
|
|
454
|
-
6. **
|
|
455
|
-
7. **Create
|
|
465
|
+
5. **Push tag to Gitea** - `git push origin main --tags` (automatically creates Gitea Release)
|
|
466
|
+
6. **Optionally mirror to GitHub** - `git push github main --tags`
|
|
467
|
+
7. **Update/Create GitHub Release manually** - via `gh release create|edit`
|
|
456
468
|
|
|
457
469
|
### Version Format
|
|
458
470
|
|
|
@@ -123,7 +123,7 @@ Before deploying any code that uses tokens:
|
|
|
123
123
|
|
|
124
124
|
Planned additions to this addon:
|
|
125
125
|
|
|
126
|
-
-
|
|
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:
|
|
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
|
package/agentic/code/frameworks/sdlc-complete/add-ons/legal/templates/data-sovereignty-template.md
CHANGED
|
@@ -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 (
|
|
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
|
|
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 (
|
|
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
|
|
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
|
-
#
|
|
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. **
|
|
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
|
-
###
|
|
116
|
+
### IaC Configuration
|
|
117
117
|
|
|
118
118
|
```hcl
|
|
119
119
|
# AWS EKS Cluster
|
|
120
120
|
module "eks" {
|
|
121
|
-
source = "
|
|
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 = "
|
|
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,
|
|
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
|
|
75
|
+
Reserved for enterprise deployments with a secrets manager or similar.
|
|
76
76
|
|
|
77
77
|
```bash
|
|
78
78
|
# Future pattern (not yet implemented)
|