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: