AIWorkflow — the dev plugin marketplace + workshop

This repo is a Claude Code plugin marketplace. It hosts the slice-development workflow as an installable plugin (dev), and it is the workshop where that workflow is measured and improved.

The workflow used to be a template you copied into each project and filled in. It is now a plugin you install once into ~/.claude; each project describes itself through its .kubecoder/project.yaml manifest (read by kc) and three lines in its CLAUDE.md. This version targets the KubeCoder environment — it is kc-native and expects kc on PATH (always true inside a KubeCoder pod).

The validated slice pipeline: /dev:triage → /dev:plan-slice → /dev:run-slice, plus /dev:write-task, /dev:slice-dag, /dev:arch-design, plus /dev:onboard to bring a repo onto the pipeline in the first place and /dev:merge-repos to fold a split backend+UI pair into one repo that can be onboarded. plan-slice settles the design with the operator, then drives a plan-writer/plan-reviewer loop (plan_loop.py) to a reviewed task breakdown; run-slice launches a kc-native task runner (task_runner.py) that drives each task through a bounded loop — branch → code-writer → test gate + test-fixer (cap 3) → consult-funded review rounds against a rising bar (backstop 5) → ff-merge → checkpoint — spawning every agent as a headless kc session. The gate is kc project test, run by the runner itself: detecting green needs no model, only fixing red does. Files are durable; sessions are ephemeral; scripts drive, agents judge.

• plugins/dev/ — the plugin: 8 skills, 11 agents, the tools (task_runner.py, plan_loop.py, close_slice.py, grounding_check.py + grounding_dispatch.py, preflight.py, and allocate-next-slice.sh, with their suites), and the contract docs (task-workflow.md and its topic docs task-runner.md / runner-state.md / agent-dispatch.md / plan-loop.md, plus grounding-ledger.md, project-contract.md, preflight.md).
• .claude-plugin/marketplace.json — makes this repo installable.

/plugin marketplace add <this repo>     # e.g. /plugin marketplace add /work/AIWorkflow
/plugin install dev@aiworkflow

Then make a repo adoptable — author a .kubecoder/project.yaml and add the three CLAUDE.md lines (Spec repo:, Slice testing strategy:, Design philosophy:). Preflight enforces the whole contract and tells a new repo exactly what is missing. See docs/ADOPTING.md.

• tools/analysis/ — slice_costs.py and runner_sessions.py: how a run's cost and session timeline are measured from state.json + the recorded transcript paths.
• workflow-improvements/ — the R&D / evidence trail behind the workflow's design.
• archive/quality/ — the retired quality capability (quality-improver, quality-issue-finder, refactor-audit) and the code_health grader, one folder per source project because the copies drifted apart. Parked while the tool is rebuilt; /dev:onboard sweeps each project's copies in here. See archive/quality/README.md. The monorepo-merge runbook that used to live in runbooks/ is now the /dev:merge-repos skill; its per-repo status lives on the issue tracker, where work state belongs.

• docs/ADOPTING.md — install the plugin and make a repo adoptable (manifest + CLAUDE.md entries), with a worked example.
• docs/AUTHORING.md — the durable rules for writing/maintaining agents, skills, and docs so they stay lean and drift-free.
• plugins/dev/docs/ — the plugin's own contract: task-workflow.md (the shared contract) with task-runner.md, runner-state.md, agent-dispatch.md, and plan-loop.md beside it, plus project-contract.md, preflight.md, and grounding-ledger.md (the claim→source ledger format and its drift checker).
• CHANGELOG-workflow.md — the plugin's changelog.