sdlc-workflow 1.2.3 → 1.2.8

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 (2) hide show
  1. package/bin/cli.js +375 -184
  2. package/package.json +1 -1
package/bin/cli.js CHANGED
@@ -252,25 +252,84 @@ globs: docs/sdlc/**/*, **/*.md
252
252
 
253
253
  # SDLC Workflow
254
254
 
255
- **On idea/feature request:** Trigger full pipeline (PO Deploy). One role per phase; run phases in sequence. (Single agent = simulate by switching role each phase.) See docs/sdlc/SDLC-WORKFLOW.md and docs/sdlc/agents/.
255
+ **On idea/feature request:** Trigger full pipeline continuously through deployment. Do not stop after one phase unless the user asks.
256
256
 
257
257
  **Memory requirement:** Before executing any new action, recall relevant memories (project context, user preferences, past decisions) to ensure continuity and avoid repeating mistakes.
258
258
 
259
- 1. **PO** PRD, user stories docs/sdlc/po/{epic-slug}/ (one folder per epic)
260
- 2. **Business BA** — FRS, process flows → docs/sdlc/ba/business/{epic-slug}/ (one folder per epic)
261
- 3. **Design (if app/web)** — Design specs + wireframes → docs/sdlc/design/{epic-slug}/; **PO + BA review** → loop until approved
262
- 4. **Architect** — ADRs, diagrams → docs/sdlc/architecture/
263
- 5. **Technical BA** — API specs, team breakdown → docs/sdlc/ba/technical/
264
- 6. **QE (docs)** — Test plan, test cases → docs/sdlc/qe/{epic-slug}/ (one folder per epic)
265
- 7. **Dev** After docs phase**run implementation immediately**. Tech Lead (highest model: planning, logic, review) + implementation roles (cost-efficient model: code execution) → docs/sdlc/dev/{role}/
266
- 8. **QE (testing + UAT)** — QE Lead + Senior QE + UAT; **bug-fix loop** (bugs → Dev fix → QE retest) until 0 bugs → docs/sdlc/qe/{epic-slug}/
267
- 9. **Security** — Audit security risk → docs/sdlc/security/
268
- 10. **Principle Engineer** — Audit logic, architecture → docs/sdlc/principle-engineer/
269
- 11. **Deploy** Docker Compose + K8s → docs/sdlc/deploy/ (after Security + PE sign-off; fix retest → re-audit loop until 0 issues)
270
- 12. **Maintenance** — Monitoring, bug fixes, patches, dependency updates → docs/sdlc/maintenance/
271
-
272
- **Each role runs as a sub-agent.** Design before Architect (UX drives tech). See docs/sdlc/agents/
273
- Full workflow: docs/sdlc/SDLC-WORKFLOW.md
259
+ **Parallel by default, sequential only when required:** If two workstreams do NOT depend on each other's output, they MUST run in parallel.
260
+
261
+ ---
262
+
263
+ ## Sequential (dependency chain)
264
+
265
+ Phase 0 Phase 1 [PO]Phase 2 [BA] Phase 3 [UX] Phase 4 [SA] Phase 5 Technical [BA]
266
+
267
+ ---
268
+
269
+ ## Parallel Track A (Technical BA completespawn immediately)
270
+
271
+ > [DEV] AND [QE] run simultaneously. Do NOT wait for one to finish before starting the other.
272
+
273
+ ```
274
+ Technical BA complete
275
+ ├──→ [DEV] implementation (all roles: [FE]/[BE]/[MOBILE]/[EMB]/[DATA]/[PLATFORM])
276
+ └──→ [QE] test plan + test cases
277
+ Both complete → Phase 8
278
+ ```
279
+
280
+ ---
281
+
282
+ ## ⚡ Parallel Track B ([DEV] complete → spawn immediately)
283
+
284
+ > [QE] + [SEC] + [PERF] audit the same artifact simultaneously.
285
+
286
+ ```
287
+ [DEV] complete
288
+ ├──→ [QE] test execution
289
+ ├──→ [SEC] security audit ← ALL IN PARALLEL
290
+ └──→ [PERF] performance audit
291
+ ↓ Merge gate (sequential)
292
+ ✅ QUALITY GATE PASSED → [OPS] Deploy
293
+ ```
294
+
295
+ ---
296
+
297
+ ## Phase sequence
298
+
299
+ 1. **Phase 1** [PO] — PRD, user stories, feasibility → docs/sdlc/po/{epic-slug}/
300
+ 2. **Phase 2** [BA] — FRS, NFR, Gherkin, process flows → docs/sdlc/ba/business/{epic-slug}/
301
+ 3. **Phase 3** [UX] (if app/web) — Design specs + wireframes; [PO]+[BA] review until approved → docs/sdlc/design/{epic-slug}/
302
+ 4. **Phase 4** [SA] — ADRs, C4 diagrams, security by design → docs/sdlc/architecture/
303
+ 5. **Phase 5** Technical [BA] — API specs (OpenAPI 3.x), team breakdown → docs/sdlc/ba/technical/
304
+ 6. **⚡ Phase 5a** [QE] + **⚡ Phase 5b** [DEV] — parallel after Technical BA
305
+ 7. **⚡ Phase 8** [QE] + [SEC] + [PERF] — parallel audits after [DEV] complete → merge gate
306
+ 8. **Phase 9** [OPS] — Docker Compose + K8s + IaC → docs/sdlc/deploy/
307
+ 9. **Phase 10** — SHIPPED ✅
308
+ 10. **Phase 11** Maintenance — monitoring, bug fixes, patches
309
+
310
+ ---
311
+
312
+ ## Quality standards
313
+
314
+ | Role | Standard |
315
+ |------|----------|
316
+ | [PO] | Every requirement traces to a business KPI |
317
+ | [BA] | Every user story has Gherkin AC + edge case |
318
+ | [UX] | Every screen: WCAG 2.1 AA + mobile-first |
319
+ | [SA] | Every ADR has rationale + trade-off |
320
+ | [DEV] | Every function: docstring + error handling + unit test (100%) |
321
+ | [QE] | 100% branch coverage; ≥3 negative paths per happy path |
322
+ | [SEC] | Zero Critical; High must have mitigation or accepted-risk doc |
323
+ | [PERF] | p95 < 500ms for API; no N+1 queries |
324
+ | [OPS] | Secrets in Vault/SSM; no hardcoded credentials; IaC passes tfsec |
325
+
326
+ ---
327
+
328
+ ## Remediation loop
329
+
330
+ Every issue must have an Issue ID (e.g. SEC-001). Track: 🔁 CYCLE 1 → 🔁 CYCLE 2 → 🔁 CYCLE 3. Max 3 cycles per issue.
331
+
332
+ **Each role runs as a sub-agent.** Design before Architect (UX drives tech). See docs/sdlc/SDLC-WORKFLOW.md and docs/sdlc/agents/
274
333
  `;
275
334
 
276
335
  const CURSOR_SKILL_MD = `---
@@ -280,25 +339,28 @@ description: Multi-role SDLC workflow from user requirements through PO, Busines
280
339
 
281
340
  # SDLC Workflow (Multi-Role)
282
341
 
283
- Sequential workflow; **each role runs as a sub-agent**. Each phase produces docs/artifacts for the next. After completiondeploy with **Docker Compose** and **K8s** (docs/sdlc/deploy/).
342
+ **Parallel by default, sequential only when required.** Each role runs as a sub-agent. Design before Architect (UX drives tech). After docs phase Dev runs immediately.
284
343
 
285
344
  ## Trigger and orchestration (mandatory)
286
345
 
287
346
  **When the user sends an idea, feature request, or new requirement:**
288
347
  1. **Recall memory** — Before executing any new action, recall relevant memories (project context, user preferences, past decisions) to ensure continuity and avoid repeating mistakes.
289
- 2. **Trigger the pipeline** and run it **continuously through deployment** (Phase 1 → 2 → … → 7).
290
- 3. **One role per phase.** For each phase, act **only** as that role (e.g. only PO in phase 1, only Business BA in phase 2). Produce that phase's outputs into the correct folder, then **continue to the next phase** without waiting for the user.
291
- 3. **Run in order:** PO → Business BA → **Design (if app/web, PO+BA review loop)** → Architect → Technical BA → QE (docs) → Dev → QE (testing + UAT) → **QE bug-fix loop until 0 bugs → Security + Principle Engineer audit → fix → retest → re-audit loop until 0 issues** → Deploy → Maintenance. Do not stop after one phase unless the user explicitly asks to stop.
348
+ 2. **Trigger the pipeline** and run it **continuously through deployment**.
349
+ 3. **One role per phase** for sequential phases. **Spawn parallel workstreams** when dependencies are independent.
292
350
 
293
- **Note:** In Cursor and similar tools there is a single agent per conversation. "Sub-agent" means **one role per phase** — the same agent must adopt exactly one role per phase and run phases in sequence (do not mix roles in one step). If the platform later supports spawning separate agents per phase, use that; otherwise this single agent simulates the pipeline by switching role each phase.
351
+ **Parallel tracks:**
352
+ - Track A (after Technical BA): [DEV] implementation + [QE] test plan — run SIMULTANEOUSLY
353
+ - Track B (after Dev complete): [QE] + [SEC] + [PERF] audits — run SIMULTANEOUSLY
354
+
355
+ **Note:** In Cursor there is a single agent per conversation. Adopt one role per sequential phase; spawn parallel tasks for Track A and Track B.
294
356
 
295
357
  **Sub-agent specs**: docs/sdlc/agents/
296
358
 
297
359
  ## Flow Overview
298
360
 
299
- \`\`\`
300
- User Request PO → Business BA → Design (if app/web) → Architect → Technical BA QE (docs) Dev → QE (testing + UAT) → [bug-fix loop until 0 bugs] → Security + PE audit → [fix → retest → re-audit loop until 0 issues] → Deploy → Maintenance
301
- \`\`\`
361
+ Sequential: Phase 0 → Phase 1 [PO] → Phase 2 [BA] → Phase 3 [UX] → Phase 4 [SA] → Phase 5 Technical [BA]
362
+ Parallel Track A: Technical BA complete → [DEV] + [QE] simultaneously
363
+ Parallel Track B: Dev complete → [QE] + [SEC] + [PERF] simultaneously → merge gate → [OPS] Deploy
302
364
 
303
365
  **Determine current phase** before acting. If user sent an idea, assume Phase 0 and start from Phase 1.
304
366
 
@@ -353,48 +415,39 @@ User Request → PO → Business BA → Design (if app/web) → Architect → Te
353
415
 
354
416
  **Role**: Create test plan, test cases before Dev implements.
355
417
  **Deliverables**: Test plan, test cases.
356
- **Output**: \`docs/sdlc/qe/{epic-slug}/\` — **one folder per epic** (same slug as PO/BA). Test plan, test cases inside. Do not put all epics in one file. After docs phase → **Dev team runs implementation immediately** (no extra gate).
418
+ **Output**: \`docs/sdlc/qe/{epic-slug}/\` — **one folder per epic** (same slug as PO/BA).
419
+ **⚡ Parallel with Phase 5b**: [DEV] starts implementation immediately after Technical BA — do NOT wait for QE docs to finish.
357
420
 
358
421
  ## Phase 5b: Dev Teams
359
422
 
360
- **Trigger**: After docs are done (Technical BA + QE docs). **Dev runs implementation immediately.**
361
-
362
- **Roles** (vary by project — use only what applies; see \`docs/sdlc/dev/implementation-roles.template.md\`). All implementation roles are **Senior (10+ yrs)**:
363
- - **Tech Lead (15+ yrs)** — **highest model** (e.g. Opus): Planning, logic analysis, architecture decisions, tech stack, code review & merge. Docs: \`docs/sdlc/dev/tech-lead/\`
364
- - **Senior Developer (10+ yrs)** — **cost-efficient model** (e.g. Haiku): Implement per Tech Lead's spec. Docs: \`docs/sdlc/dev/senior-developer/\`
365
- - **Senior Frontend (10+ yrs)**: Web UI. Docs: \`docs/sdlc/dev/frontend/\`
366
- - **Senior Backend (10+ yrs)**: API, services. Docs: \`docs/sdlc/dev/backend/\`
367
- - **Senior Mobile (10+ yrs)**: iOS/Android/cross-platform. Docs: \`docs/sdlc/dev/mobile/\`
368
- - **Senior Embedded (10+ yrs)**: Firmware, IoT. Docs: \`docs/sdlc/dev/embedded/\`
369
- - **Senior Data/ML (10+ yrs)**: ETL, models. Docs: \`docs/sdlc/dev/data-ml/\`
370
- - **Senior Platform (10+ yrs)**: Infra, CI/CD. Docs: \`docs/sdlc/dev/platform/\`
371
-
372
- **Model optimization**: Tech Lead uses the **highest-tier model** (e.g. Claude Opus) for planning, architecture decisions, logic analysis, and code review. Implementation roles use a **cost-efficient model** (e.g. Claude Haiku) to execute code from Tech Lead's specs. This maximizes quality on critical thinking while reducing cost on execution.
423
+ **Trigger**: After Technical BA is complete (not after QE docs). **Dev runs implementation immediately.**
424
+ **⚡ Parallel with Phase 5a**: [DEV] AND [QE] test plan run simultaneously.
373
425
 
374
- **Requirements**: Unit Test coverage **≥ 90%** (TDD/BDD); Clean Code, SOLID, DRY, KISS, SoC, POLS.
426
+ **Roles** (vary by project use only what applies). All implementation roles are **Senior (10+ yrs)**:
427
+ - **Tech Lead (15+ yrs)** — **highest model** (e.g. Opus): Planning, logic analysis, architecture decisions, tech stack, code review & merge.
428
+ - **Senior Frontend (10+ yrs)**: Web UI.
429
+ - **Senior Backend (10+ yrs)**: API, services, DB.
430
+ - **Senior Mobile (10+ yrs)**: iOS/Android/cross-platform.
431
+ - **Senior Embedded (10+ yrs)**: Firmware, IoT.
432
+ - **Senior Data/ML (10+ yrs)**: ETL, models, analytics.
433
+ - **Senior Platform (10+ yrs)**: CI/CD, infra.
375
434
 
376
- **Output**: Code + unit tests. **Handoff to QE (testing + UAT).**
435
+ **⚡ All implementation roles run in parallel** frontend does NOT wait for backend; they coordinate via API contract from Technical BA.
377
436
 
378
- ## Phase 6: QE (Testing phase automation + UAT) bug-fix loop
437
+ **Requirements**: Unit Test coverage **100%** (TDD/BDD); Clean Code, SOLID, DRY, KISS, SoC, POLS.
438
+ **Output**: Code + unit tests. **Handoff to Phase 8.**
379
439
 
380
- **Trigger**: After Dev completes unit tests.
381
- **Role**: Write and run **automation tests** + **UAT**, sign-off.
440
+ ## Phase 8: [QE] + [SEC] + [PERF] Quality Gates (⚡ fully parallel audits)
382
441
 
383
- **Roles**:
384
- - **QE Lead (15+ yrs automation)**: Test strategy, framework choice, automation architecture, review test code. Output per epic: \`docs/sdlc/qe/{epic-slug}/\`
385
- - **Senior QE (10+ yrs)**: Write automation tests per QE Lead's strategy. Output per epic: \`docs/sdlc/qe/{epic-slug}/\` (e.g. automation/ or test files there)
386
- - **UAT**: Verify implementation against original user stories and acceptance criteria from PO.
442
+ **Trigger**: After Dev completes implementation (code + 100% coverage).
443
+ **⚡ All three audits run SIMULTANEOUSLY on the same artifact.** Do NOT wait for one to finish before starting another.
387
444
 
388
- **Bug-fix loop**: If QE finds bugs or test failures **Dev fixes** **QE retests**. **Repeat until all tests pass and UAT approved (0 open bugs).** Only then → **Handoff to Security + Principle Engineer.**
389
-
390
- ## Phase 8: Security + Principle Engineer (audit fix → retest → re-audit loop)
391
-
392
- **Trigger**: After QE testing sign-off (0 open bugs).
393
- **Roles** (can run in parallel):
394
- - **Security team**: Audit security risk (OWASP, auth, secrets, infra). Output: \`docs/sdlc/security/\`
395
- - **Principle Engineer**: Audit logic, architecture alignment, correctness. Output: \`docs/sdlc/principle-engineer/\`
445
+ - **[QE]**: Execute all test suites, enforce 100% coverage gate, report bugs (QE-001...).
446
+ - **[SEC]**: OWASP Top 10, STRIDE threat model, CVE scan, compliance (GDPR/PCI/SOC2). Report: SEC-001...
447
+ - **[PERF]**: Latency benchmarks (p95<500ms), N+1 detection, k6 load test. Report: PERF-001...
396
448
 
397
- **Fix retest re-audit loop**: If issues/vulnerabilities found **Dev fixes****QE retests** (verify fix, no regression) **Security + PE re-audit**. **Repeat until 0 issues/vulnerabilities remain.** Only when sign-off → **Handoff to Deploy.**
449
+ **Merge gate**: Collect all findings from all three. If Critical/High🔁 REMEDIATION LOOP [DEV] fix → [QE] retest re-audit. Max 3 cycles per issue.
450
+ **Quality Gate PASSED** → [OPS] Deploy.
398
451
 
399
452
  ## Phase 9: Deploy
400
453
 
@@ -413,7 +466,7 @@ User Request → PO → Business BA → Design (if app/web) → Architect → Te
413
466
  | 4 | Architect | ADRs, system diagrams, security by design |
414
467
  | 5 | Technical BA | API specs, tech breakdown |
415
468
  | 6 | QE (docs) | Test plan, test cases |
416
- | 7 | Dev | Code, unit tests (≥90%), security shift-left |
469
+ | 7 | Dev | Code, unit tests (100%), security shift-left |
417
470
  | 8 | QE (testing + UAT) | Automation, UAT; **bug-fix loop** (QE finds bugs → Dev fix → QE retest) until 0 open bugs |
418
471
  | 9 | Security + PE | Audit; **fix → retest → re-audit loop** (Dev fix → QE retest → re-audit) until 0 issues; sign-off → Deploy |
419
472
  | 10 | Deploy | Docker Compose + K8s |
@@ -425,12 +478,23 @@ See reference.md for templates.
425
478
 
426
479
  const CURSOR_REFERENCE_MD = `# SDLC Workflow — Reference
427
480
 
428
- ## Folder structure: one per epic/feature (PO and Business BA)
481
+ ## Execution model
482
+
483
+ **Parallel by default, sequential only when required.**
484
+
485
+ | Decision | Rule |
486
+ |----------|------|
487
+ | Sequential phases | Phase 0 → 1 → 2 → 3 → 4 → 5 Technical BA |
488
+ | Track A (after Technical BA) | [DEV] + [QE] run SIMULTANEOUSLY — do NOT wait |
489
+ | Dev parallel roles | [FE] + [BE] + [MOBILE] + [EMB] + [DATA] + [PLATFORM] all run simultaneously |
490
+ | Track B (after Dev complete) | [QE] + [SEC] + [PERF] run SIMULTANEOUSLY — merge gate only after all report |
491
+
492
+ ## Folder structure: one per epic/feature
429
493
 
430
494
  - **PO**: \`docs/sdlc/po/{epic-slug}/\` — one folder per epic. Files: epic-brief.md, user-stories.md. Do not put all epics in one file.
431
495
  - **Business BA**: \`docs/sdlc/ba/business/{epic-slug}/\` — same slug as PO. Files: functional-requirements.md, process-flows.md. Do not merge all epics into one file.
432
496
  - **Design (if app/web)**: \`docs/sdlc/design/{epic-slug}/\` — same slug as PO/BA. Design specs (Markdown) + optional HTML wireframes; PO+BA review until approved.
433
- - **QE**: \`docs/sdlc/qe/{epic-slug}/\` — same slug as PO/BA. Files: test-plan.md, test-cases.md, automation artifacts. Do not put all epics in one file.
497
+ - **QE**: \`docs/sdlc/qe/{epic-slug}/\` — same slug as PO/BA. Files: test-plan.md, test-cases.md, automation. Do not put all epics in one file.
434
498
 
435
499
  ## PO: Epic Brief Template
436
500
  # Epic: [Name]
@@ -452,21 +516,22 @@ Design specs (Markdown) + optional HTML wireframes from idea + PO + BA (before A
452
516
  TC-001: [Scenario] — Precondition, Steps, Expected, Links to AC
453
517
 
454
518
  ## QE Team (one folder per epic: qe/{epic-slug}/)
455
- - QE Lead (15+ yrs automation): test strategy, framework, automation architecture, review → docs/sdlc/qe/{epic-slug}/
456
- - Senior QE (10+ yrs): write automation tests → docs/sdlc/qe/{epic-slug}/
519
+ - QE Lead (15+ yrs automation) — **highest model** (e.g. Opus): test strategy, framework, automation architecture, review → docs/sdlc/qe/{epic-slug}/
520
+ - Senior QE (10+ yrs) — **cost-efficient model** (e.g. Haiku): write automation tests per QE Lead's strategy → docs/sdlc/qe/{epic-slug}/
457
521
 
458
522
  ## Dev Team
459
523
  - Tech Lead (15+ yrs) — **highest model** (e.g. Opus): planning, logic, architecture decisions, code review → docs/sdlc/dev/tech-lead/
460
- - Senior Dev (10+ yrs) — **cost-efficient model** (e.g. Haiku): execute code from Tech Lead specs, Unit Test ≥90% → docs/sdlc/dev/senior-developer/
524
+ - Senior Dev (10+ yrs) — **cost-efficient model** (e.g. Haiku): execute code from Tech Lead specs, Unit Test 100% → docs/sdlc/dev/senior-developer/
461
525
  - By project (all Senior 10+ yrs, cost-efficient model): Senior Frontend, Backend, Mobile, Embedded, Data/ML, Platform → docs/sdlc/dev/{role}/
462
526
 
463
- ## Security + Principle Engineer (after implementation)
464
- - Security team: audit security risk → docs/sdlc/security/
465
- - Principle Engineer: audit logic, architecture → docs/sdlc/principle-engineer/
466
- - **Fix loop**: If issues Dev fixes QE retests → re-audit; repeat until 0 issues. Sign-off → Deploy
527
+ ## Security + Principle Engineer + Performance (after implementation)
528
+ - Security team [SEC]: OWASP Top 10, STRIDE, CVE, compliance → docs/sdlc/security/
529
+ - Principle Engineer [PE]: logic, architecture → docs/sdlc/principle-engineer/
530
+ - Performance Auditor [PERF]: p95<500ms, N+1, k6docs/sdlc/security/
531
+ - **Remediation loop**: Every issue has ID (SEC-001, PERF-003...). 🔁 CYCLE 1 → 2 → 3. Max 3 per issue.
467
532
 
468
533
  ## Deploy
469
- After Security + Principle Engineer sign-off → Docker Compose + K8s. See docs/sdlc/deploy/
534
+ After all Phase 8 issues resolved → Docker Compose + K8s + IaC. See docs/sdlc/deploy/
470
535
 
471
536
  ## Maintenance
472
537
  After Deploy → ongoing: monitoring, bug fixes, patches, dependency updates, performance tuning. Significant new features → loop back to PO for new epic. See docs/sdlc/maintenance/
@@ -474,25 +539,24 @@ After Deploy → ongoing: monitoring, bug fixes, patches, dependency updates, pe
474
539
 
475
540
  const AGENTS_MD_CONTENT = `## SDLC Workflow
476
541
 
477
- **Trigger:** When the user sends an **idea**, **feature request**, or **requirement**, run the full pipeline (Phase 1 → 7) in sequence. One role (sub-agent) per phase; produce outputs then continue to the next. Do not stop after one phase until deployment unless the user asks to stop.
542
+ **Trigger:** When the user sends an **idea**, **feature request**, or **requirement**, run the full pipeline continuously through deployment. Do not stop after one phase unless the user asks.
478
543
 
479
544
  **Memory requirement:** Before executing any new action, recall relevant memories (project context, user preferences, past decisions) to ensure continuity and avoid repeating mistakes.
480
545
 
481
- When working on requirements, features, or handoffs, follow these phases:
546
+ **Parallel by default, sequential only when required.**
482
547
 
483
- 1. **PO** — PRD, user stories → docs/sdlc/po/{epic-slug}/ (one folder per epic)
484
- 2. **Business BA** — FRS, process flows → docs/sdlc/ba/business/{epic-slug}/ (one folder per epic)
485
- 3. **Design (if app/web)** — Design specs + wireframes (**Anti AI**: no AI-looking designs) → docs/sdlc/design/{epic-slug}/; **PO + BA review** until approved
486
- 4. **Architect** — ADRs, diagrams → docs/sdlc/architecture/
487
- 5. **Technical BA** — API specs, team breakdown → docs/sdlc/ba/technical/
488
- 6. **QE (docs)** Test plan, test cases docs/sdlc/qe/{epic-slug}/ (one folder per epic)
489
- 7. **Dev** After docs phase → **run implementation immediately**. Tech Lead (highest model: planning, logic, review) + Senior Dev (cost-efficient model: code execution) → docs/sdlc/dev/{role}/
490
- 8. **QE (testing + UAT)** QE Lead + Senior QE + UAT; **bug-fix loop** (bugs Dev fix → QE retest) until 0 bugs → docs/sdlc/qe/{epic-slug}/ (same folder per epic)
491
- 9. **Security + Principle Engineer** — Security + logic audit; **fix → retest → re-audit loop** (Dev fixes → QE retests → re-audit) until 0 issues; sign-off before Deploy
492
- 10. **Deploy** — Docker Compose + K8s → docs/sdlc/deploy/
493
- 11. **Maintenance** — Monitoring, bug fixes, patches, dependency updates → docs/sdlc/maintenance/
494
-
495
- Design before Architect (UX drives tech). After the docs phase, the Dev team runs implementation immediately. See docs/sdlc/agents/
548
+ 1. **Phase 1** [PO] — PRD, user stories, feasibility → docs/sdlc/po/{epic-slug}/
549
+ 2. **Phase 2** [BA] — FRS, NFR, Gherkin, process flows → docs/sdlc/ba/business/{epic-slug}/
550
+ 3. **Phase 3** [UX] (if app/web) — Design specs + wireframes; [PO]+[BA] review until approved → docs/sdlc/design/{epic-slug}/
551
+ 4. **Phase 4** [SA] — ADRs, C4 diagrams, security by design → docs/sdlc/architecture/
552
+ 5. **Phase 5** Technical [BA] — API specs (OpenAPI 3.x), team breakdown → docs/sdlc/ba/technical/
553
+ 6. **⚡ Phase 5a** [QE] + **⚡ Phase 5b** [DEV] parallel after Technical BA
554
+ 7. **⚡ Phase 8** [QE] + [SEC] + [PERF] parallel audits after [DEV] complete merge gate
555
+ 8. **Phase 9** [OPS]Docker Compose + K8s + IaC → docs/sdlc/deploy/
556
+ 9. **Phase 10** — SHIPPED
557
+ 10. **Phase 11** Maintenance monitoring, bug fixes, patches
558
+
559
+ Design before Architect (UX drives tech). After Technical BA, [DEV] runs immediately — parallel with [QE] docs. See docs/sdlc/agents/
496
560
  `;
497
561
 
498
562
  const CLAUDE_SDLC_CONTENT = `## SDLC Workflow
@@ -501,19 +565,23 @@ const CLAUDE_SDLC_CONTENT = `## SDLC Workflow
501
565
 
502
566
  **Memory requirement:** Before executing any new action, recall relevant memories (project context, user preferences, past decisions) to ensure continuity and avoid repeating mistakes.
503
567
 
568
+ **Parallel by default, sequential only when required:** If two workstreams do NOT depend on each other's output, they MUST run in parallel.
569
+
504
570
  1. **PO** — PRD, user stories, feasibility assessment → docs/sdlc/po/{epic-slug}/ (one folder per epic)
505
- 2. **Business BA** — FRS, NFR, process flows → docs/sdlc/ba/business/{epic-slug}/ (one folder per epic)
571
+ 2. **Business BA** — FRS, NFR, Gherkin, process flows → docs/sdlc/ba/business/{epic-slug}/ (one folder per epic)
506
572
  3. **Design (if app/web)** — Design specs + wireframes (**Anti AI**: no AI-looking designs) → docs/sdlc/design/{epic-slug}/; **PO + BA review** until approved
507
- 4. **Architect** — ADRs, diagrams, security by design, engineering principles (SOLID, DRY, KISS, CQRS, Zero Trust, EDA, HA) → docs/sdlc/architecture/
508
- 5. **Technical BA** — API specs, team breakdown → docs/sdlc/ba/technical/
509
- 6. **QE (docs)** Test plan, test cases docs/sdlc/qe/{epic-slug}/ (one folder per epic)
510
- 7. **Dev** — After docs phase → **run implementation immediately**. Tech Lead (highest model: planning, logic, review) + Senior Dev (cost-efficient model: code execution) → docs/sdlc/dev/{role}/. Clean Code, SOLID, DRY, KISS, TDD/BDD. Security shift-left: OWASP checks, dependency audit in CI
511
- 8. **QE (testing + UAT)** QE Lead + Senior QE + UAT; **bug-fix loop** (bugs → Dev fix → QE retest) until 0 bugs → docs/sdlc/qe/{epic-slug}/ (same folder per epic)
512
- 9. **Security + Principle Engineer** — Security + logic audit; **fix retest re-audit loop** (Dev fixes → QE retests → re-audit) until 0 issues; sign-off before Deploy
513
- 10. **Deploy** Docker Compose + K8s docs/sdlc/deploy/
514
- 11. **Maintenance** Monitoring, bug fixes, patches, dependency updates docs/sdlc/maintenance/
515
-
516
- Design before Architect (UX drives tech). After the docs phase, Dev runs implementation immediately. See docs/sdlc/agents/
573
+ 4. **Architect** — ADRs, C4 diagrams, security by design, engineering principles (SOLID, DRY, KISS, CQRS, Zero Trust, EDA, HA) → docs/sdlc/architecture/
574
+ 5. **Technical BA** — API specs (OpenAPI 3.x), team breakdown → docs/sdlc/ba/technical/
575
+ 6. **⚡ Phase 5a [QE]** + **⚡ Phase 5b [DEV]** run in PARALLEL after Technical BA:
576
+ - [QE]: test plan + test cases → docs/sdlc/qe/{epic-slug}/ (100% coverage target)
577
+ - [DEV]: code + unit tests (100%) → docs/sdlc/dev/{role}/ start immediately, do NOT wait for QE docs
578
+ 7. **⚡ Phase 8** — [QE] + [SEC] + [PERF] audit SIMULTANEOUSLY after Dev complete:
579
+ - Bug-fix loop [DEV] fix[QE] retest until 0 bugs
580
+ - 🔁 Remediation loop: issue ID per finding, max 3 cycles, until 0 Critical/High issues
581
+ 8. **Deploy** — Docker Compose + K8s + IaC → docs/sdlc/deploy/ (after all Phase 8 issues resolved)
582
+ 9. **Maintenance** Monitoring, bug fixes, patches, dependency updates docs/sdlc/maintenance/
583
+
584
+ Design before Architect (UX drives tech). After Technical BA, Dev runs immediately — parallel with QE docs. See docs/sdlc/agents/
517
585
  `;
518
586
 
519
587
  const SDLC_WORKFLOW_MD = `# SDLC Workflow (Multi-Role)
@@ -545,7 +613,7 @@ User Request → PO → Business BA → Design (if app/web) → Architect → Te
545
613
  | 4 | Architect | ADRs, system diagrams, security by design |
546
614
  | 5 | Technical BA | API specs, tech breakdown |
547
615
  | 6 | QE (docs) | Test plan, test cases |
548
- | 7 | Dev | Code, unit tests (≥90%), security shift-left |
616
+ | 7 | Dev | Code, unit tests (100%), security shift-left |
549
617
  | 8 | QE (testing + UAT) | Automation, UAT; **bug-fix loop** (QE finds bugs → Dev fix → QE retest) until 0 open bugs |
550
618
  | 9 | Security + PE | Audit; **fix → retest → re-audit loop** (Dev fix → QE retest → re-audit) until 0 issues; sign-off → Deploy |
551
619
  | 10 | Deploy | Docker Compose + K8s |
@@ -585,7 +653,7 @@ User Request → PO → Business BA → Design (if app/web) → Architect → Te
585
653
  ### Phase 5b: Dev Teams
586
654
  - **Tech Lead (15+ yrs)**: Tech stack, review & merge, **security review (Shift Left)**: OWASP check, dependency audit, SAST in CI. Output: \`docs/sdlc/dev/tech-lead/\`
587
655
  - **Implementation roles** (all Senior 10+ yrs; use only what applies): Senior Dev, Senior Frontend, Senior Backend, Senior Mobile, Senior Embedded, Senior Data/ML, Senior Platform → \`docs/sdlc/dev/{role}/\`. See \`implementation-roles.template.md\`.
588
- - **Requirement**: Unit Test coverage **≥ 90%** (TDD/BDD); Clean Code, SOLID, DRY, KISS, SoC, POLS; security practices (input validation, no hardcoded secrets)
656
+ - **Requirement**: Unit Test coverage **100%** (TDD/BDD); Clean Code, SOLID, DRY, KISS, SoC, POLS; security practices (input validation, no hardcoded secrets)
589
657
  - **Then**: QE starts testing phase
590
658
 
591
659
  ### Phase 6: QE (Testing — automation + UAT) → bug-fix loop
@@ -615,134 +683,253 @@ User Request → PO → Business BA → Design (if app/web) → Architect → Te
615
683
  See [reference.md](./reference.md) for templates.
616
684
  `;
617
685
 
618
- const ORCHESTRATION_MD = `# Pipeline orchestration
686
+ const ORCHESTRATION_MD = `# Pipeline Orchestration
619
687
 
620
688
  ## Trigger
621
689
 
622
- When the user sends an **idea**, **feature request**, or **requirement** (e.g. "I want a login page", "We need an API for X"):
623
-
624
- 1. **Trigger the full pipeline** and run **Phase 1 2 → 11 in sequence**.
625
- 2. **One role per phase:** For each phase, act only as that role, write outputs to the correct \`docs/sdlc/...\` folder, then **continue to the next phase** without asking the user to "run next step".
690
+ When the user sends an **idea**, **feature request**, or **requirement**:
691
+ 1. **Trigger the full pipeline** and run continuously through deployment.
692
+ 2. **One role per phase** for sequential phases. **Spawn parallel workstreams** when dependencies are independent.
626
693
  3. **Run through to Maintenance.** Do not stop after PO, BA, or Dev unless the user explicitly says to stop.
627
694
 
628
- ## How it runs (Cursor and similar)
695
+ ## 🚦 The Orchestrator's Most Important Rule
696
+
697
+ > **Parallel by default. Sequential only when required.**
698
+
699
+ Before running any two workstreams, ask: "Does workstream B depend on workstream A's output?"
700
+ - **Yes** → Run sequentially (A first, then B)
701
+ - **No** → **Run in parallel immediately**
629
702
 
630
- There is **one agent** per conversation. It simulates the pipeline by **adopting one role per phase** in order: Phase 1 as PO only → Phase 2 as Business BA only → … → Phase 11 as Maintenance. Do not mix roles in one step. If the tool later supports separate agents per phase, use that; otherwise this single-agent simulation is correct.
703
+ ## Execution Map
704
+
705
+ Sequential: Phase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5 Technical BA
706
+ Parallel Track A: Technical BA complete → [DEV] + [QE] simultaneously
707
+ Parallel Track B: Dev complete → [QE] + [SEC] + [PERF] simultaneously → merge gate → [OPS] Deploy
631
708
 
632
709
  ## Checklist per run
633
710
 
634
- - [ ] Phase 1 PO: artifacts in \`docs/sdlc/po/{epic-slug}/\` (one folder per epic)
635
- - [ ] Phase 2 Business BA: \`docs/sdlc/ba/business/{epic-slug}/\` (one folder per epic)
636
- - [ ] Phase 3 Design (if app/web): design specs + wireframes in \`docs/sdlc/design/{epic-slug}/\`; PO+BA review until approved
637
- - [ ] Phase 4 Architect: \`docs/sdlc/architecture/\`
638
- - [ ] Phase 5 Technical BA: \`docs/sdlc/ba/technical/\`
639
- - [ ] Phase 6 QE docs: \`docs/sdlc/qe/{epic-slug}/\` (one folder per epic)
640
- - [ ] Phase 7 Dev: code + unit tests, \`docs/sdlc/dev/\`
641
- - [ ] Phase 8 QE testing + UAT: automation, UAT; **bug-fix loop** (bugs → Dev fix → QE retest) until 0 open bugs → \`docs/sdlc/qe/{epic-slug}/\`
642
- - [ ] Phase 9 Security + Principle Engineer: audit → **fix → retest → re-audit loop** until 0 issues/vulnerabilities; sign-off → \`docs/sdlc/security/\`, \`docs/sdlc/principle-engineer/\`
643
- - [ ] Phase 10 Deploy: \`docs/sdlc/deploy/\`, Docker Compose + K8s
644
- - [ ] Phase 11 Maintenance: monitoring, bug fixes, patches, dependency updates → \`docs/sdlc/maintenance/\`
711
+ ### Sequential phases
712
+ - [ ] Phase 0 Discovery: raw request captured
713
+ - [ ] Phase 1 [PO]: artifacts in \`docs/sdlc/po/{epic-slug}/\`
714
+ - [ ] Phase 2 [BA]: \`docs/sdlc/ba/business/{epic-slug}/\`
715
+ - [ ] Phase 3 [UX] (if app/web): \`docs/sdlc/design/{epic-slug}/\`; [PO]+[BA] review until approved
716
+ - [ ] Phase 4 [SA]: \`docs/sdlc/architecture/\`
717
+ - [ ] Phase 5 Technical [BA]: \`docs/sdlc/ba/technical/\`
718
+
719
+ ### Parallel Track A (spawn immediately after Phase 5)
720
+ - [ ] Spawn [DEV] implementation (all roles: [FE]/[BE]/[MOBILE]/[EMB]/[DATA]/[PLATFORM])
721
+ - [ ] Spawn [QE] test plan + test cases in parallel
722
+ - [ ] Do NOT wait for one to finish before starting the other
723
+
724
+ ### ⚡ Parallel Track B (spawn when [DEV] is complete)
725
+ - [ ] Spawn [QE] test execution
726
+ - [ ] Spawn [SEC] security audit
727
+ - [ ] Spawn [PERF] performance audit
728
+ - [ ] All three run simultaneously — merge gate only after all complete
729
+
730
+ ### Post-merge
731
+ - [ ] Phase 9 [OPS]: \`docs/sdlc/deploy/\`
732
+ - [ ] Phase 10: Project Completion Package → SHIPPED ✅
733
+ - [ ] Phase 11 Maintenance
645
734
  `;
646
735
 
647
736
  const REFERENCE_MD = `# SDLC Workflow — Reference
648
737
 
649
- Templates and examples. Use \`*.template.md\` as starting points.
650
- Templates are written for all project types: web, mobile, API-only, library/SDK, CLI, data/ML, platform/infra.
651
- Sub-agents: docs/sdlc/agents/
652
- Deploy: docs/sdlc/deploy/ (Docker Compose + K8s)
738
+ ## Execution model
739
+
740
+ **Parallel by default, sequential only when required.**
741
+
742
+ | Decision | Rule |
743
+ |----------|------|
744
+ | Sequential phases | Phase 0 → 1 → 2 → 3 → 4 → 5 Technical BA |
745
+ | Track A (after Technical BA) | [DEV] + [QE] run SIMULTANEOUSLY |
746
+ | Dev parallel roles | [FE] + [BE] + [MOBILE] + [EMB] + [DATA] + [PLATFORM] all simultaneously |
747
+ | Track B (after Dev complete) | [QE] + [SEC] + [PERF] run SIMULTANEOUSLY — merge gate after all report |
653
748
 
654
749
  ## Folder structure: one per epic/feature
655
750
 
656
751
  - **PO**: \`docs/sdlc/po/{epic-slug}/\` — one folder per epic. Files: epic-brief.md, user-stories.md. Do not put all epics in one file.
657
752
  - **Business BA**: \`docs/sdlc/ba/business/{epic-slug}/\` — same slug as PO. Files: functional-requirements.md, process-flows.md. Do not merge all epics into one file.
658
- - **Design (if app/web)**: \`docs/sdlc/design/{epic-slug}/\` — design specs (Markdown) + optional HTML wireframes; PO+BA review until approved.
753
+ - **Design (if app/web)**: \`docs/sdlc/design/{epic-slug}/\` — same slug as PO/BA. Design specs (Markdown) + optional HTML wireframes; PO+BA review until approved.
659
754
  - **QE**: \`docs/sdlc/qe/{epic-slug}/\` — same slug as PO/BA. Files: test-plan.md, test-cases.md, automation. Do not put all epics in one file.
660
- - **Security**: \`docs/sdlc/security/\` — security audit; fix → retest → re-audit loop until 0 issues
661
- - **Principle Engineer**: \`docs/sdlc/principle-engineer/\` — logic audit; fix → retest → re-audit loop until 0 issues
662
- - **Maintenance**: \`docs/sdlc/maintenance/\` — monitoring, bug fixes, patches, runbooks
755
+
756
+ ## Quality standards
757
+
758
+ | Role | Standard |
759
+ |------|----------|
760
+ | [PO] | Every requirement traces to a business KPI |
761
+ | [BA] | Every user story has Gherkin AC + edge case |
762
+ | [UX] | Every screen: WCAG 2.1 AA + mobile-first |
763
+ | [SA] | Every ADR has rationale + trade-off |
764
+ | [DEV] | Every function: docstring + error handling + unit test (100%) |
765
+ | [QE] | 100% branch coverage; ≥3 negative paths per happy path |
766
+ | [SEC] | Zero Critical; High must have mitigation or accepted-risk doc |
767
+ | [PERF] | p95 < 500ms for API; no N+1 queries |
768
+ | [OPS] | Secrets in Vault/SSM; no hardcoded credentials; IaC passes tfsec |
769
+
770
+ ## Remediation loop
771
+
772
+ Every issue must have an Issue ID (e.g. SEC-001). Track: 🔁 CYCLE 1 → 🔁 CYCLE 2 → 🔁 CYCLE 3. Max 3 cycles per issue.
663
773
  `;
664
774
 
665
775
  const AGENTS_README = `# Sub-Agents
666
776
 
667
777
  Every role in the SDLC runs as a **sub-agent**. Each phase is assigned to a corresponding sub-agent.
778
+ **Role badges are mandatory** — every artifact must identify which \`[ROLE]\` produced it.
779
+
780
+ ## 🚦 Parallel vs Sequential Orchestrator Rules
781
+
782
+ **The cardinal rule:** If two workstreams do NOT depend on each other's output, they MUST run in parallel.
783
+
784
+ ### Sequential (mandatory — dependency chain)
785
+
786
+ Phase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5 Technical BA
787
+ Each phase's output is the next phase's input. Skipping or reordering causes rework.
788
+
789
+ ### Parallel: Track A — Implementation + Test Plan
790
+
791
+ > **Spawn immediately when Technical BA completes.** Do NOT wait for one to finish before starting the other.
792
+
793
+ Technical BA complete → [DEV] implementation + [QE] test plan run SIMULTANEOUSLY.
794
+ All implementation roles ([FE]/[BE]/[MOBILE]/[EMB]/[DATA]/[PLATFORM]) also run in parallel.
795
+
796
+ ### Parallel: Track B — Quality Gates
797
+
798
+ > **Spawn immediately when [DEV] is complete.** All three agents audit the same artifact simultaneously.
799
+
800
+ [DEV] complete → [QE] + [SEC] + [PERF] run SIMULTANEOUSLY → merge gate → Deploy.
801
+
802
+ ### Remediation Loop
803
+
804
+ Every issue must have an Issue ID (e.g. SEC-001). Track: 🔁 CYCLE 1 → 🔁 CYCLE 2 → 🔁 CYCLE 3. Max 3 cycles per issue.
805
+
806
+ ## Role Sub-Agent Table
807
+
808
+ | Role | Input | Output | Parallel? |
809
+ |------|-------|--------|-----------|
810
+ | [PO] | User request | docs/sdlc/po/{epic-slug}/ | Sequential |
811
+ | [BA] | PO output | docs/sdlc/ba/business/{epic-slug}/ | Sequential |
812
+ | [UX] | BA output | docs/sdlc/design/{epic-slug}/ | Sequential |
813
+ | [SA] | BA + UX | docs/sdlc/architecture/ | Sequential |
814
+ | [BA] Tech | SA output | docs/sdlc/ba/technical/ | Sequential |
815
+ | [DEV] | Tech BA | docs/sdlc/dev/{role}/ | ⚡ Parallel with [QE] |
816
+ | [QE] | Tech BA | docs/sdlc/qe/{epic-slug}/ | ⚡ Parallel with [DEV] |
817
+ | [QE]+[SEC]+[PERF] | Dev output | TER, SAR, PAR | ⚡ Fully parallel |
818
+ | [OPS] | All Phase 8 passed | docs/sdlc/deploy/ | Sequential |
819
+
820
+ ## Quality Standards
821
+
822
+ | Role | Standard |
823
+ |------|----------|
824
+ | [PO] | Every requirement traces to a business KPI |
825
+ | [BA] | Every user story has Gherkin AC + edge case |
826
+ | [UX] | Every screen: WCAG 2.1 AA + mobile-first |
827
+ | [SA] | Every ADR has rationale + trade-off |
828
+ | [DEV] | Every function: docstring + error handling + unit test (100%) |
829
+ | [QE] | 100% branch coverage; ≥3 negative paths per happy path |
830
+ | [SEC] | Zero Critical; High must have mitigation or accepted-risk doc |
831
+ | [PERF] | p95 < 500ms for API; no N+1 queries |
832
+ | [OPS] | Secrets in Vault/SSM; no hardcoded credentials; IaC passes tfsec |
668
833
 
669
- | Role | Sub-agent | Input | Output |
670
- |------|-----------|--------|--------|
671
- | PO | po | User request | docs/sdlc/po/{epic-slug}/ (one folder per epic) |
672
- | Business BA | business-ba | docs/sdlc/po/{epic-slug}/ | docs/sdlc/ba/business/{epic-slug}/ (one folder per epic) |
673
- | Design (if app/web) | design | docs/sdlc/po + docs/sdlc/ba/business/ | docs/sdlc/design/{epic-slug}/; PO+BA review until approved |
674
- | Architect | architect | docs/sdlc/ba/business/ + design (if any) | docs/sdlc/architecture/ |
675
- | Technical BA | technical-ba | docs/sdlc/architecture/ + design (if any) | docs/sdlc/ba/technical/ |
676
- | QE (docs) | qe-docs | docs/sdlc/ba/technical/ (+ design if any) | docs/sdlc/qe/{epic-slug}/ (one folder per epic) |
677
- | Tech Lead | tech-lead | Technical spec | Review, merge, docs/sdlc/dev/tech-lead/ |
678
- | Senior Dev | senior-dev | Spec + test plan | After docs → run implementation immediately. Code, unit tests (≥90%) |
679
- | Senior Frontend | frontend | UI spec, API contract | Web UI, docs/sdlc/dev/frontend/ |
680
- | Senior Backend | backend | API spec, DB schema | API, services, docs/sdlc/dev/backend/ |
681
- | Senior Mobile | mobile | API contract, design | App (iOS/Android), docs/sdlc/dev/mobile/ |
682
- | Senior Embedded | embedded | HW/spec, interfaces | Firmware, IoT, docs/sdlc/dev/embedded/ |
683
- | Senior Data/ML | data-ml | Data spec, models | ETL, models, docs/sdlc/dev/data-ml/ |
684
- | Senior Platform | platform | Infra spec | CI/CD, observability, docs/sdlc/dev/platform/ |
685
- | QE Lead | qe-lead | Test plan | 15+ yrs automation: strategy, framework, review → docs/sdlc/qe/{epic-slug}/ |
686
- | Senior QE | senior-qe | Test plan + framework | Automation tests → docs/sdlc/qe/{epic-slug}/ |
687
- | Security | security | Code, infra | Security audit → docs/sdlc/security/; fix → retest → re-audit loop until 0 issues |
688
- | Principle Engineer | principle-engineer | Code, architecture | Logic audit → docs/sdlc/principle-engineer/; fix → retest → re-audit loop until 0 issues |
689
- | Deploy | deploy | Security + PE sign-off (after 0 issues) | Docker Compose + K8s, docs/sdlc/deploy/ |
690
- | Maintenance | maintenance | Live application | Monitoring, bug fixes, patches, docs/sdlc/maintenance/ |
691
-
692
- Orchestrator: run each sub-agent in order; hand off output → input of the next sub-agent.
693
-
694
- **Trigger:** On user idea/request, run the full pipeline (see docs/sdlc/ORCHESTRATION.md). One role per phase; single agent simulates by switching role each phase. Do not stop after one phase until Deploy unless the user asks.
834
+ ## Response Format (Mandatory)
835
+
836
+ \`\`\`
837
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
838
+ 🏢 APEX [PHASE NAME] | [ROLE BADGE]
839
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
840
+
841
+ 📋 INPUT RECEIVED
842
+ [What was received from previous phase or business]
843
+
844
+ 🔄 PROCESSING
845
+ [Current role's analysis/work]
846
+
847
+ 📤 OUTPUT ARTIFACT: [Artifact Name]
848
+ [Full artifact content]
849
+
850
+ 🚦 GATE STATUS
851
+ [ ] Pending review [✅] Approved [🔴] Blocked reason: ...
852
+
853
+ ⏭️ NEXT ACTION
854
+ [What triggers next, which role activates, what they need]
855
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
856
+ \`\`\`
857
+
858
+ See docs/sdlc/SDLC-WORKFLOW.md for full phase details.
695
859
  `;
696
860
 
697
- const SECURITY_README = `# Security Team
861
+ const SECURITY_README = `# Security Team | [SEC]
698
862
 
699
- **When:** After implementation (Dev) and QE testing (0 open bugs). **Before** Deploy.
863
+ **When:** After [QE] quality gate passed (0 open bugs + 100% coverage). Runs **parallel** with [PERF] audit. **Before** Deploy.
700
864
 
701
- **Role:** Audit security risk in code, APIs, infra, and configuration. Identify vulnerabilities and recommend mitigations.
865
+ **Quality Standard:** Zero tolerance for Critical severity. High must have documented mitigation or accepted-risk doc.
702
866
 
703
- **Fix retest → re-audit loop:** If issues/vulnerabilities found → **Dev fixes** → **QE retests** (verify fix, no regression) → **Security re-audit**. Repeat until 0 issues/vulnerabilities remain; then sign-off to Deploy.
867
+ ## Detailed Tasks
704
868
 
705
- ## Detailed tasks
869
+ - [ ] **OWASP Top 10 checklist:** A01 Broken Access Control → A10 SSRF
870
+ - [ ] **STRIDE threat model:** Spoofing, Tampering, Repudiation, Information Disclosure, DoS, Elevation of Privilege
871
+ - [ ] **SAST findings:** Static analysis (Semgrep, SonarQube, Bandit)
872
+ - [ ] **CVE scan:** npm audit / pip audit / trivy
873
+ - [ ] **Auth/Authorization review:** JWT, sessions, RBAC
874
+ - [ ] **Secrets management:** No hardcoded credentials; verify Vault/SSM
875
+ - [ ] **Compliance notes:** GDPR / PCI-DSS / SOC2 / HIPAA (activate per project type)
876
+
877
+ ## Issue Tracking
878
+
879
+ Issue ID (SEC-001...), Severity (Critical/High/Medium/Low), Status, Owner, Mitigation.
706
880
 
707
- - [ ] **Read implementation**: Code, API specs, infra configs (docker-compose, k8s)
708
- - [ ] **Security audit**: OWASP Top 10, auth/authz, injection, XSS, CSRF, secrets exposure, dependency vulns
709
- - [ ] **Infra/ops security**: Network, TLS, RBAC, secrets management
710
- - [ ] **Report**: Findings, severity, remediation; output to \`docs/sdlc/security/\`
711
- - [ ] **Fix → retest → re-audit loop**: If issues found → Dev fixes → **QE retests** (confirm fix, no regression) → Security re-audit. **Repeat until 0 issues/vulnerabilities remain**; then sign-off to Deploy.
881
+ ## Merge Gate
882
+
883
+ Critical 🔴 BLOCK. High without mitigation 🔴 BLOCK. High with accepted-risk → ⚠️ CONDITIONAL.
884
+
885
+ See docs/sdlc/SDLC-WORKFLOW.md for full audit details.
712
886
  `;
713
887
 
714
888
  const PRINCIPLE_ENGINEER_README = `# Principle Engineer
715
889
 
716
- **When:** After implementation (Dev) and QE testing (0 open bugs). **Before** Deploy.
890
+ **When:** After [QE] quality gate passed. Runs **parallel** with [SEC] + [PERF]. **Before** Deploy.
717
891
 
718
- **Role:** Audit logic, architecture alignment, design decisions, and technical quality. Ensure correctness and consistency with specs.
892
+ ## Detailed Tasks
719
893
 
720
- **Fix retest re-audit loop:** If issues found **Dev fixes** → **QE retests** (verify fix, no regression) → **PE re-audit**. Repeat until 0 issues remain; then sign-off to Deploy.
894
+ - [ ] **Logic audit:** Business logic correctness, edge cases, error handling, data flow
895
+ - [ ] **Architecture audit:** Alignment with ADRs, patterns, scalability, maintainability
896
+ - [ ] **Report:** Findings, recommendations → docs/sdlc/principle-engineer/
721
897
 
722
- ## Detailed tasks
898
+ ## Issue Tracking
723
899
 
724
- - [ ] **Read implementation**: Code, architecture ADRs, Technical BA spec
725
- - [ ] **Logic audit**: Business logic correctness, edge cases, error handling, data flow
726
- - [ ] **Architecture audit**: Alignment with ADRs, patterns, scalability, maintainability
727
- - [ ] **Report**: Findings, recommendations; output to \`docs/sdlc/principle-engineer/\`
728
- - [ ] **Fix retestre-audit loop**: If logic/arch issues found Dev fixes**QE retests** (confirm fix, no regression) PE re-audit. **Repeat until 0 issues remain**; then sign-off to Deploy.
900
+ Issue ID (PE-001...), Severity, Status, Owner.
901
+
902
+ ## Merge Gate
903
+
904
+ Critical/High logic issues🔴 BLOCK 🔁 CYCLE 1[DEV] fix[QE] retest → re-audit. Max 3 cycles.
729
905
  `;
730
906
 
731
- const DEPLOY_README = `# Deploy
907
+ const DEPLOY_README = `# [OPS] — Infrastructure & Deployment
908
+
909
+ **When:** After [SEC] + [PERF] + [PE] sign-off (all Critical/High = 0). **Before** Maintenance.
732
910
 
733
- After the pipeline completes (Security + Principle Engineer sign-off, after fix retest → re-audit loop until 0 issues), deploy immediately with:
911
+ **Quality Standard:** All secrets in Vault/SSM. No hardcoded credentials. IaC must pass tfsec/checkov.
734
912
 
735
- **After Deploy → Maintenance phase**: monitoring, bug fixes, patches, dependency updates.
913
+ ## Deployment
736
914
 
737
- - **Docker Compose** — local / staging: \`docker compose up -d\`
738
- - **Kubernetes** production: \`kubectl apply -f k8s/\`
915
+ \`\`\`bash
916
+ docker compose up -d # local / staging
917
+ kubectl apply -f k8s/ # production
918
+ \`\`\`
919
+
920
+ ## Deliverables
921
+
922
+ - **Docker Compose + Kubernetes:** docker-compose.yml, k8s/deployment.yaml, service.yaml, ingress.yaml
923
+ - **Terraform (optional):** VPC, ECS/EKS, RDS, IAM, SSL, remote state backend
924
+ - **Ansible (optional):** Inventory, roles, playbooks, zero-downtime rolling deploy
925
+ - **CI/CD:** lint → test (100% coverage gate) → build → scan → deploy → smoke-test
926
+ - **IaC security:** tfsec / checkov — block if HIGH severity
739
927
 
740
- ## Files
928
+ ## Gate
741
929
 
742
- - \`docker-compose.yml.template\` copy to \`docker-compose.yml\`, adjust image/env
743
- - \`k8s/deployment.yaml.template\` — Deployment
744
- - \`k8s/service.yaml.template\` Service
745
- - \`k8s/ingress.yaml.template\` — Ingress (optional)
930
+ tfsec/checkov HIGH → 🔴 BLOCK. Secrets in source → 🔴 BLOCK. [SEC]/[PERF] unresolved → 🔴 BLOCK.
931
+
932
+ See docs/sdlc/SDLC-WORKFLOW.md for full details.
746
933
  `;
747
934
 
748
935
  const DOCKER_COMPOSE_TEMPLATE = `# Copy to docker-compose.yml and adjust image, env, ports.
@@ -1152,6 +1339,8 @@ Use test-case.template.md for test cases.
1152
1339
 
1153
1340
  const QE_LEAD_README = `# QE Lead (15+ years exp in test automation)
1154
1341
 
1342
+ > **Model**: Use the **highest-tier model** (e.g. Claude Opus) for this role. QE Lead handles test strategy, framework decisions, automation architecture, and review — tasks that require maximum reasoning capability.
1343
+
1155
1344
  **Profile**: 15+ years of experience in test automation, test strategy, and quality engineering. Owns test automation strategy, framework selection, and quality gates across the project.
1156
1345
 
1157
1346
  **Responsibilities**:
@@ -1175,6 +1364,8 @@ const QE_LEAD_README = `# QE Lead (15+ years exp in test automation)
1175
1364
 
1176
1365
  const QE_SENIOR_README = `# Senior QE (10+ years exp)
1177
1366
 
1367
+ > **Model**: Use a **cost-efficient model** (e.g. Claude Haiku). Execute test implementation from QE Lead's strategy and specs.
1368
+
1178
1369
  **Responsibilities**:
1179
1370
  - Write automation tests per test plan
1180
1371
  - Implement E2E, integration, regression tests
@@ -1327,7 +1518,7 @@ const DEV_SENIOR_README = `# Senior Developer (10+ years exp)
1327
1518
 
1328
1519
  **Responsibilities**:
1329
1520
  - Implement features per Tech Lead's implementation plan and Technical BA spec
1330
- - Write code with Unit Test coverage **≥ 90%**
1521
+ - Write code with Unit Test coverage **100%**
1331
1522
  - Follow Tech Lead's tech decisions
1332
1523
 
1333
1524
  ## Detailed tasks
@@ -1335,7 +1526,7 @@ const DEV_SENIOR_README = `# Senior Developer (10+ years exp)
1335
1526
  - [ ] **Read Technical BA spec**: API, schema, team breakdown
1336
1527
  - [ ] **Implement feature**: Code per spec; follow Tech Lead stack. Adhere to: Clean Code, SOLID, DRY, KISS, SoC, LoD, CoI, GRASP, POLS
1337
1528
  - [ ] **Security practices (Shift Left)**: Input validation, parameterized queries, no hardcoded secrets, follow Architect's security ADR
1338
- - [ ] **Unit tests (TDD/BDD)**: Coverage **≥ 90%**; TDD (write tests first) or BDD (behavior specs); edge cases, error paths, BSR (Behavior-Structure-Result)
1529
+ - [ ] **Unit tests (TDD/BDD)**: Coverage **100%**; TDD (write tests first) or BDD (behavior specs); edge cases, error paths, BSR (Behavior-Structure-Result)
1339
1530
  - [ ] **PR**: Lint, tests, security scan passing; request Tech Lead review
1340
1531
  - [ ] **Output**: Code + implementation notes in \`dev/senior-developer/\`
1341
1532
  `;
@@ -1385,7 +1576,7 @@ const DEV_FRONTEND_README = `# Senior Frontend (10+ years exp) — Web UI
1385
1576
 
1386
1577
  **Responsibilities**:
1387
1578
  - Implement web UI per design and API contract
1388
- - Unit Test coverage **≥ 90%**
1579
+ - Unit Test coverage **100%**
1389
1580
  - Follow Tech Lead's stack (e.g. React, Vue, Angular)
1390
1581
 
1391
1582
  ## Detailed tasks
@@ -1393,7 +1584,7 @@ const DEV_FRONTEND_README = `# Senior Frontend (10+ years exp) — Web UI
1393
1584
  - [ ] **Read Technical BA spec**: API contract, design (if any)
1394
1585
  - [ ] **Implement components/screens**: Per spec; responsive, accessible
1395
1586
  - [ ] **API integration**: Fetch, state, error handling
1396
- - [ ] **Unit tests (TDD/BDD)**: Components, hooks, utils — coverage **≥ 90%**; follow Clean Code, SOLID, DRY, KISS
1587
+ - [ ] **Unit tests (TDD/BDD)**: Components, hooks, utils — coverage **100%**; follow Clean Code, SOLID, DRY, KISS
1397
1588
  - [ ] **PR**: Lint, tests; Tech Lead review
1398
1589
  - [ ] **Output**: Code + component/integration docs in \`dev/frontend/\`
1399
1590
  `;
@@ -1404,7 +1595,7 @@ const DEV_BACKEND_README = `# Senior Backend (10+ years exp) — API, services
1404
1595
 
1405
1596
  **Responsibilities**:
1406
1597
  - Implement API, services, DB layer per Technical BA spec
1407
- - Unit Test coverage **≥ 90%**
1598
+ - Unit Test coverage **100%**
1408
1599
  - Follow Tech Lead's stack
1409
1600
 
1410
1601
  ## Detailed tasks
@@ -1412,7 +1603,7 @@ const DEV_BACKEND_README = `# Senior Backend (10+ years exp) — API, services
1412
1603
  - [ ] **Read Technical BA spec**: API spec, DB schema
1413
1604
  - [ ] **Implement endpoints**: Per spec; validation, auth, error responses
1414
1605
  - [ ] **Implement DB layer**: Migrations, queries, transactions
1415
- - [ ] **Unit tests (TDD/BDD)**: Services, controllers, DB — coverage **≥ 90%**; follow Clean Code, SOLID, DRY, KISS
1606
+ - [ ] **Unit tests (TDD/BDD)**: Services, controllers, DB — coverage **100%**; follow Clean Code, SOLID, DRY, KISS
1416
1607
  - [ ] **PR**: Lint, tests; Tech Lead review
1417
1608
  - [ ] **Output**: Code + API/DB implementation notes in \`dev/backend/\`
1418
1609
  `;
@@ -1423,7 +1614,7 @@ const DEV_MOBILE_README = `# Senior Mobile (10+ years exp) — iOS / Android / c
1423
1614
 
1424
1615
  **Responsibilities**:
1425
1616
  - Implement app UI and API integration per spec
1426
- - Unit Test coverage **≥ 90%**
1617
+ - Unit Test coverage **100%**
1427
1618
  - Follow Tech Lead's stack (e.g. React Native, Flutter, native)
1428
1619
 
1429
1620
  ## Detailed tasks
@@ -1431,7 +1622,7 @@ const DEV_MOBILE_README = `# Senior Mobile (10+ years exp) — iOS / Android / c
1431
1622
  - [ ] **Read Technical BA spec**: API contract, screen flows
1432
1623
  - [ ] **Implement screens/modules**: Per spec; platform parity (iOS/Android)
1433
1624
  - [ ] **API integration**: Auth, state, offline (if required)
1434
- - [ ] **Unit tests (TDD/BDD)**: Components, logic — coverage **≥ 90%**; follow Clean Code, SOLID, DRY, KISS
1625
+ - [ ] **Unit tests (TDD/BDD)**: Components, logic — coverage **100%**; follow Clean Code, SOLID, DRY, KISS
1435
1626
  - [ ] **PR**: Lint, tests; Tech Lead review
1436
1627
  - [ ] **Output**: Code + screen/module docs in \`dev/mobile/\`
1437
1628
  `;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdlc-workflow",
3
- "version": "1.2.3",
3
+ "version": "1.2.8",
4
4
  "description": "Scaffold SDLC workflow docs and templates for Cursor, Claude, and dev teams",
5
5
  "type": "module",
6
6
  "bin": {