unic / unic/unic-agents-plugins

tech-debt(unic-archon-dlc): the design-contract half is 28% of the /specs command file

Open
#451 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc needs-specs p2 tech-debt
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.