cc-architecture-builder

Audit CC project workspace against CAB v1.1.0 standards. Read-only 8-dimension scored assessment with YAML + markdown artifacts; Dimension 8 covers DP8 wrap-and-extend compliance. Triggers: audit workspace, check standards, cab audit, workspace health check, assess CC setup, dp8 compliance check.

Triage UX-log entries marked downstream_target=LL into formal lessons-learned.md entries with verifiable enforcement layer citations per LL-33 protocol. Operates on notes/ux-log-*.csv rows; outputs LL-NN entries + Priority Queue updates + bidirectional cross-references. Triggers: triage lessons, promote UX-log to LL, codify lesson, LL promotion, run lesson triage.

Enforce PLAN → REVIEW → EXECUTE → VERIFY → COMMIT protocol for non-trivial tasks. Prevents one-shotting, premature completion, and scope drift. Triggers: implement feature, fix bug, refactor, multi-step task.

Detect drift between CAB plugin extensions (source of truth) and deployed global ~/.claude/ extensions. Three failure modes detected: content drift, scope-shadowing across local→user→plugin layers (LL-27), AND type-shadowing at the same scope when commands and skills share names (LL-32). Triggers: sync check, plugin drift, shadow scan, type collision, deploy alignment, before pushing CAB changes, after global config edits.

Create or extend Claude Code project structures. Five modes via --mode flag: default (interactive new project), plugin (CAB plugin scaffold + git + optional GitHub remote), integrate (overlay CC architecture onto existing codebase), global (set up ~/.claude/ user config), quick (template-driven fast scaffold, no questionnaire). Triggers: new project, scaffold, init plugin, integrate existing, global config, quick template, start project.

Generate SOW, implementation plans, acceptance criteria, and phased backlogs. Decomposes requirements into actionable deliverables. Triggers: plan project, scope feature, write requirements, create SOW, define acceptance criteria.

Reconstruct session context after mid-dialogue death (compaction crash, force-close, dropped connection, hung process). Bootstraps from notes/ first, identifies the dying-session JSONL transcript, extracts last N turns, synthesizes coverage gap vs current state files, backfills discoveries into LL/state, and resumes at the exact HITL question. Triggers: session crashed, lost context, force-compact recovery, dying session, transcript recovery, recover from compaction.

Scan codebase for technical debt: code duplication, stale TODO/FIXME markers, dead code, consistency drift, and dependency health. Classifies findings as auto-fixable, manual-review, or tracked-known. Triggers: tech debt scan, end-of-session cleanup, code health check, periodic audit, before refactor.

Alias for `scaffold-project --mode quick`. Preserves the "quick-scaffold" skill-name trigger after the Phase 3c.2 hybrid merge (UXL-002). All logic + templates live in `skills/scaffold-project/`. Triggers: quick scaffold, generate template, fast setup, placeholder files.

Stage changes, commit with a concise descriptive message, push to the remote, and open a pull request in one workflow. Pre-computes git status/diff so the commit message and PR description are accurate and context-rich. Triggers: commit and push, ship changes, open PR, publish work, end-of-task commit, finalize and PR.

Regenerate INDEX.md files for a knowledge base from current file structure and YAML frontmatter metadata. Triggers: regenerate KB index, update INDEX.md, knowledge base reorganization, after KB file moves, kb hygiene check.

Pull recent project activity from git log, open PRs, issues, and optional MCP-connected sources (Slack, GitHub) into a concise session-bootstrap context summary. Triggers: bootstrap session, context sync, what's been happening, recent activity, resume after time away.

Deep codebase analysis and system architecture design. Covers structure review, component decomposition, data modeling, API design, and ADRs. Triggers: review architecture, analyze code, evaluate design, assess scalability, tech stack eval.

Cleanly close session with state persistence and context handoff. Updates progress.md, TODO.md, current-task.md. Triggers: close, wrap up, save state, session done, ending session, context full.

Scaffold individual CC components (skills, agents, commands, hooks) with proper frontmatter, naming, and template compliance. Triggers: add skill, add agent, create command, add hook, extend project with new component.

Review notes/ state artifacts before git push to catch in-dev drafts, private content, or unintended publication of state files. Triggers: before pushing, pre-push check, about to sync, publishing state, ready to push.

Validate CC project structure against CAB conventions. Checks required files, plugin.json, CLAUDE.md, components, security, and KB. Triggers: validate project, check structure, audit plugin, verify compliance, pre-publish check.