Skip to content

plans: ck plugin phase-one PRD from the agent-workflows proposal - #5

Draft
d6veteran wants to merge 1 commit into
mainfrom
claude/code-katz-plugin-prd-34gbso
Draft

plans: ck plugin phase-one PRD from the agent-workflows proposal#5
d6veteran wants to merge 1 commit into
mainfrom
claude/code-katz-plugin-prd-34gbso

Conversation

@d6veteran

Copy link
Copy Markdown
Contributor

Summary

Turns plans/2026-09-05-agent-workflows-research-and-proposal.md (committed here alongside, since it was on no branch) into a phase-one PRD for a single code-katz plugin named ck: 21 persona subagents generated from team-cli profiles, /ck:panel (three lenses on three models) and /ck:prd (River-led, panel-challenged) end to end, one instrumentation hook, no UI.

What is in the PRD

  • Proposal §8 resolved first. Q2 sets the shape: a sign-off is a gate in a skill (the only place AskUserQuestion exists); each span between gates that needs fan-out is one plugin workflow; a single-agent span runs inline. Docs quote: "For sign-off between stages, run each stage as its own workflow."
  • Fifteen corrections to the proposal (§3.3), each graded and with the consequence. Load-bearing: the plugin must be named ck (the command prefix is the plugin name); proposal §5.5 (each lens on a different model) contradicts §5.6 (River, Toni, Kai all on Opus 5) and is resolved by a per-invocation model override in panel.js only; seven personas left unassigned in §5.6 are placed; TaskCompleted/Stop hook gates become in-workflow validation; PreModelSwitch does not cover subagent fallback; the roster is 21, not 22.
  • Plugin vs web app vs wrapper vs dashboard (§4.7): plugin. /workflows is the run view; a phase-two /ck:map renders the catalog from workflow meta; a workbench, if ever, is local and never a hosted app with its own store.
  • Full specs for personas-as-subagents (vendored upstream at a pinned commit, mechanical rewrite of interactive behaviors, drift test), /ck:panel, /ck:prd, packaging, tests, deferred items, risks.
  • Appendices carry both workflow scripts (syntax-checked as the runtime runs them), both skills, the generated River agent excerpt, a cost model at 2026-09-05 prices, and sources.

Also in this PR

  • DEVLOG.md: decision entry recording the marketplace reversal for ck only, the gate rule, the tier-upstream-first rule, and the UI stance.
  • plans/2026-09-05-agent-workflows-research-and-proposal.md: the input document, verbatim.

Not in this PR

No code. The code-katz/ck repository, the team-cli tiers.conf PR, and the marketplace entry are the build, which starts from this PRD.

🤖 Generated with Claude Code

https://claude.ai/code/session_014aqcjmXas9EFDx3pstfpyE


Generated by Claude Code

… a devlog entry

Turn the 2026-09-05 agent-workflows research proposal into a phase-one PRD for a
single code-katz plugin named ck: 21 persona subagents generated from team-cli
profiles, /ck:panel (three lenses on three models) and /ck:prd (River-led,
panel-challenged) end to end, one instrumentation hook, no UI.

- Resolves proposal section 8; Q2 sets the shape: gates live in skills, each
  span between gates is one plugin workflow, single-agent spans run inline.
- Records fifteen corrections to the proposal, led by the plugin name (the
  command prefix is the plugin name, so it must be ck) and the section 5.5 vs
  5.6 model contradiction, resolved by a per-invocation override in panel.js.
- Answers plugin vs web app vs wrapper vs dashboard: plugin; /workflows is the
  run view; a phase-two /ck:map renders the catalog from meta; any workbench is
  local, never a hosted app with its own store.
- Commits the proposal alongside so the PRD's derives-from link resolves.
- Appendices carry both workflow scripts, both skills, the generated River
  agent excerpt, a cost model at 2026-09-05 prices, and sources.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014aqcjmXas9EFDx3pstfpyE
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants