Pdca Watch
Productivitypdca-watchPdca Watch is an Agent Skill for productivity published in the popup-studio-ai/bkit-claude-code repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Live PDCA dashboard ticking every 30s — reads pdca-status.json + token-ledger.ndjson tail, renders fixed-width panel via CC /loop. Triggers: pdca watch, live dashboard, watch progress, 실시간 대시보드, ライブダッシュボード, 实时仪表板, panel en vivo, tableau de bord.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/popup-studio-ai/bkit-claude-code/blob/HEAD/skills/pdca-watch/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pdca-watch, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
PDCA Watch — Live Tick Dashboard
v2.1.11 Sprint β FR-β4. Wraps
lib/dashboard/watch.jsover CC's/loop(v2.1.71+). Read-only — only consumes state files; never writes. Falls back to a single render when/loopis unsupported (E-β4-01).
Arguments
| Argument | Description | Example |
|---|---|---|
| (none) | Auto-resolve active feature from pdca-status.primaryFeature | /pdca-watch |
<feature> | Watch a specific feature by name | /pdca-watch bkit-v2111-integrated-enhancement |
Behavior
Resolution
- If
<feature>is provided, use it verbatim. - Else read
.bkit/state/pdca-status.json→primaryFeature, thenactiveFeatures[0]as fallback. - If still no feature → render
"No active PDCA feature. Start one with /pdca pm <feature>"and exit.
Tick (every 30s via /loop)
For each tick, lib/dashboard/watch.js#renderTick produces a panel with:
Watch <feature> — tick N (HH:MM:SS)
─────────────────────────────────────────────────────────────
Phase: <phase> Match: <%> Iter: <n / 5>
Tokens: <in> in / <out> out · samples <N>
Est cost: $<USD>
─────────────────────────────────────────────────────────────
Data sources:
- Phase / matchRate / iterationCount:
pdca-status.features[<feature>] - Token totals: last 50 lines of
token-ledger.ndjson - Cost: Sonnet-class flat estimate ($3/Mtok in, $15/Mtok out)
Termination
- Ctrl-C from user
- Feature
phase === 'completed'orphase === 'archived' - After max 60 ticks (≈30 min) — caller restarts if more time needed
CC /loop Support
| CC Version | Behavior |
|---|---|
| ≥ 2.1.71 | Native /loop 30s ticker |
| < 2.1.71 | E-β4-01: single render + warning, no loop |
| Unknown | Same as < 2.1.71 (fail-safe) |
The check is performed via watch.checkLoopSupport({ ccVersion }) —
caller passes the resolved CC version from lib/infra/cc-version-checker.
Security
- Pure read on
.bkit/state/pdca-status.jsonand.bkit/runtime/token-ledger.ndjson. - Tail bounded to
MAX_TAIL_LINES = 200regardless of caller input — defends against pathological NDJSON growth. - No subprocess spawning, no network.
- PII redaction on the ledger is owned by the writer (Token Accountant); watch only reads what's already redacted.
Module Dependencies
| Module | Function | Usage |
|---|---|---|
lib/dashboard/watch.js | resolveFeature() | Auto-detect when no arg |
lib/dashboard/watch.js | renderTick() | One frame per tick |
lib/dashboard/watch.js | tailLedger() | NDJSON tail (≤200) |
lib/dashboard/watch.js | checkLoopSupport() | CC version gate |
lib/infra/cc-version-checker.js | getCurrent() | Version source |
Examples
# Auto-detect active feature
/pdca-watch
# Watch a specific feature
/pdca-watch bkit-v2111-integrated-enhancement
Related
/pdca status— single snapshot (no loop)/control trust— trust score informs auto-escalation/pdca-fast-track— Daniel-mode auto-approve checkpoints
ARGUMENTS: