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)
- Config enabled —
bkit.config.json#control.fastTrack.enabled === true - Trust Score ≥ 80 —
.bkit/state/trust-profile.json#trustScore≥fastTrack.minTrustScore(default 80) - Design doc exists — resolved via
bkit.config.json#pdca.docPaths.designtemplates 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)
- Recommend Automation Level escalation L2 →
fastTrack.autoLevel(defaultL3). - 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": [] } - Each Checkpoint 1-8 invocation calls
fast-track.recordCheckpointto append a decision entry (audit trail). - If a Checkpoint surfaces NO "Recommended" option, call
recordCheckpoint({ decision: 'fallback', reason: 'no_recommended' })and pause tofallbackLevel.
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 untrustedfeaturearg (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: