popup-studio-ai/pdca-fast-track

PDCA Fast Track — Daniel's Track

v2.1.11 Sprint β FR-β5. Wraps lib/control/fast-track.js. Provides a single auto-escalation gate for users who have already earned Trust ≥ 80 and produced a Design doc — Checkpoints 1-8 default to Recommended without prompting. Falls back to L2 + manual review the moment any preconditions fails (E-β5-01 / E-β5-02).

Arguments

| Argument | Description | Example | |----------|-------------|---------| | <feature> | Feature name to engage fast-track for | /pdca-fast-track bkit-v2111-integrated-enhancement |

Behavior

Preconditions (all must pass; fail-open)

1. Config enabled — bkit.config.json#control.fastTrack.enabled === true
2. Trust Score ≥ 80 — .bkit/state/trust-profile.json#trustScore ≥ fastTrack.minTrustScore (default 80)
3. Design doc exists — resolved via bkit.config.json#pdca.docPaths.design templates against <feature>

When any block, surface the reason with a remedy hint:

| Block | Remedy hint | |-------|-------------| | disabled_in_config | "Set control.fastTrack.enabled = true in bkit.config.json" | | trust_score_too_low | "Run a few /pdca check cycles to raise trust" | | design_doc_missing | "Run /pdca design <feature> first" |

On engage (all preconditions pass)

1. Recommend Automation Level escalation L2 → fastTrack.autoLevel (default L3).
2. Persist engagement record to .bkit/runtime/fast-track-log.json:

   {
     "engaged": true,
     "feature": "<feature>",
     "engagedAt": "<ISO>",
     "trustScore": 85,
     "autoLevel": "L3",
     "fallbackLevel": "L2",
     "skipCheckpoints": [1,2,3,4,5,6,7,8],
     "designPath": "docs/02-design/features/<feature>.design.md",
     "decisions": []
   }
   

3. Each Checkpoint 1-8 invocation calls fast-track.recordCheckpoint to append a decision entry (audit trail).
4. If a Checkpoint surfaces NO "Recommended" option, call recordCheckpoint({ decision: 'fallback', reason: 'no_recommended' }) and pause to fallbackLevel.

Security

• All file IO is rooted at process.env.CLAUDE_PROJECT_DIR (or repo root).
• Audit log JSON is OWASP A08-clean: no user-controlled keys; only whitelisted checkpoint (number), decision (enum), reason (sanitized string).
• Design doc patterns are read from bkit.config.json — no traversal via untrusted feature arg (pattern is {feature} placeholder only).
• Trust score read is fail-safe: missing file returns 0 (blocks engage).

Module Dependencies

| Module | Function | Usage | |--------|----------|-------| | lib/control/fast-track.js | evaluatePreconditions(feature) | Block list | | lib/control/fast-track.js | engage(feature) | Audit + record | | lib/control/fast-track.js | recordCheckpoint({...}) | Per-CP decision | | lib/control/fast-track.js | isCheckpointSkipped(n) | Should we skip? |

Examples

# Engage on a Design-complete feature
/pdca-fast-track bkit-v2111-integrated-enhancement

# Result if Trust < 80
# Block: trust_score_too_low (current 68 < required 80)

# Result if Design missing
# Block: design_doc_missing → run /pdca design first

Related

• /control trust — current Trust Score breakdown
• /control level <0-4> — manual override
• /pdca-watch — observe progress while fast-tracking
• /pdca design <feature> — required prerequisite

ARGUMENTS: