unic / unic/unic-agents-plugins
tech-debt(unic-archon-dlc): the design-contract half is 28% of the /specs command file
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 16h 43m
- Merged PRs (30d)
- 19
Description
The problem
apps/claude-code/unic-archon-dlc/commands/specs.md is 441 lines. The design-contract section under Step 7 is 122 of them — 28% of a command named for producing a PRD, spent on how to read a design system and what a contract holds. It arrived as the third amendment to the branch-on-input ADR (the design branch, #416) and now outweighs several of the steps around it.
Why it is worth a ticket
Two of /specs' three halts are one sentence each. In run 2 of the chain on DXP-DesignSystem (WI 43004) both were walked past while the run's own report is almost entirely contract facts — the agent spent itself where the prose is. That is filed as #441, whose "did not decide" list records the length-as-cause link as inference, not measurement: nobody has shown that shortening the file makes a halt hold.
So this is not a style complaint and it is not #441's fix. It is the one structural relief available for a file whose length is the suspected reason its own rules were skipped, and #441's criteria land in that file either way.
The shape, not yet decided
A second command sharing the gate is the obvious candidate — the contracts already ride the PRD's pull request, so the gate is where they meet. What is undecided is whether a Consumer wants two invocations, and whether a feature that names no component should pay for a command it never runs.
Grill this before writing criteria. The instinct to "just move the block" is what produced the amendment that put it here.
Related
- #441 — the halts that did not halt; this ticket is the relief for the length its "did not decide" list names
- Sibling spin-off: rewrite the branch-on-input ADR as its own current state
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading apps/claude-code/unic-archon-dlc/commands/specs.md, especially Step 7 and the design-contract section, alongside related issue #441 and the branch-on-input ADR referenced in the issue. Before implementation, determine the command boundary, invocation expectations, and criteria for handling features without a named component; done means those decisions are agreed and the resulting structure is defined.
Written by the indexing model from the issue text.
Assessment
- Domain
- cli
- Issue type
- Refactor
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100