Skip to content

fix(unic-archon-dlc): remove references back to this repository from what a Consumer reads - #673

Merged
orioltf merged 14 commits into
developfrom
feature/unic-archon-dlc/556-no-links-back-to-this-repo
Oct 28, 2026
Merged

orioltf merged 14 commits into
developfrom
feature/unic-archon-dlc/556-no-links-back-to-this-repo

Conversation

@orioltf

@orioltf orioltf commented Oct 28, 2026

Copy link
Copy Markdown
Member

Why

A Consumer session reads this Plugin's commands from the Plugin cache and its Boxes from the Consumer's own .archon/workflows/. Both pointed back at this repository. A relative ADR link resolved against the Consumer's working directory and found nothing, or the Consumer's own ADR of that number. A copied Box read ADR-0023 or #281 as the Consumer's own decision or issue. /setup also wrote a URL to this repository into the Consumer's CLAUDE.md.

What changes

  • Commands. Every link to a Plugin ADR, every citation by number and every issue link is gone. A reference that served only a human reader is removed. Where a command depended on the ADR's content, it states the rule inline. /archon-upgrade now states the sub-run trigger and the node-schema traps in its own text.
  • /setup. It checks that <installPath>/README.md is present and reads § Dependencies, § Configuration reference and § The tracker contract from it. The CLAUDE.md block replaces the URL with one line per Box. The sentence about docs/boxes/ is gone.
  • /improve-architecture. It picks the ADR home from the Consumer's existing docs/adr/ directories and confirms it with the user. With none, it proposes the root docs/adr/.
  • Boxes. All four drop every Plugin ADR and issue number, in comments and in prompt text. Two places state the rule inline: the evidence script comment in unic-dlc-build.yaml, and the structural-bar comment in unic-dlc-pr-review.yaml.
  • README. The 28 bare ADR citations become links into its own docs/adr/, which resolve inside the installed Plugin. All 47 citations are now links, and each target exists.
  • AGENTS.md. A new doctrine states the rule and names a link, a path and a citation by number. It records that nothing checks the rule mechanically.
  • Release. 0.36.1, with the entry under ### Fixed.

Kept on purpose

The steps that read the Consumer's own docs/adr/ stay:

  • commands/specs.md reads "all ADRs in docs/adr/" and "the ADRs in docs/adr/ that decide a testing approach".
  • unic-dlc-explore.yaml keeps "Read docs/adr/ entries (newest five by filename)" and "root CONTEXT.md / CONTEXT-MAP.md and docs/adr/".
  • unic-dlc-build.yaml keeps the report step that drafts an ADR as docs/adr/NNNN-<slug>.md and stages each new one by name.

Beyond the ticket's patterns

The opener's grep does not match bare issue numbers such as (#281). The Boxes held 24 of them, and they fail in a Consumer the same way an ADR number does, so they are gone too.

Checks

  • grep -rnE '\]\((\.\./)?docs/adr/|ADR-?0[0-9]{3}|unic-agents-plugins|docs/boxes' commands .archon prints nothing.
  • pnpm check and pnpm typecheck pass.
  • pnpm --filter unic-archon-dlc verify:changelog passes.
  • Each Box parses as YAML.

The Box edits stay unproven until a Consumer run reads them.

Closes #556

🤖 Generated with Claude Code

orioltf and others added 5 commits October 28, 2026 18:56
…e commands

A command runs from the Plugin cache, so a relative ADR link resolves against the
Consumer's working directory and finds nothing, or the Consumer's own ADR. The
commands drop every Plugin ADR link and citation, and state a rule inline where they
needed one.

/setup reads its README sections from <installPath>/README.md and writes one line per
Box into the Consumer's CLAUDE.md in place of the URL. /improve-architecture picks the
ADR home from the Consumer's own docs/adr/ directories.

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/setup copies the Boxes into a Consumer, where ADR-0023 or #281 names the
Consumer's own ADR or issue. The Boxes drop every such citation, in comments and in
prompt text, and state the rule inline in the two places that needed it. The steps
that read the Consumer's own docs/adr/ stay.

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/setup reads the README from the installed Plugin, where a link into docs/adr/
resolves. The bare ADR citations become such links.

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The rule names a link, a path and a citation by number. Nothing checks it
mechanically, and the sentence says so.

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
orioltf and others added 9 commits October 28, 2026 19:03
…reads

The README, the bundle README, the explore Box and /tickets cited this repository's issues or planning steps by number. A Consumer reads those numbers as its own. Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…E section /setup reads

/setup now stops when a README section it reads is missing, and its CLAUDE.md block says the pr-review and qa confirmations depend on the gates keys. /archon-upgrade ties DEFER to its own locked precedents, and /improve-architecture handles any number of ADR homes. Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…uard sentence

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…me rule

Step 3 said MADR-lite always applies, while Step 6 follows the chosen home's existing format and uses MADR-lite only in an empty home. Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The bundle README named lib/methods-manifest.mjs, the root AGENTS.md and the root .prettierignore, and described a licence-hash check and a test that no longer exist. It now states each rule itself. Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…UDE.md block

The block now lists the Boxes, so /setup and AGENTS.md say so and say how the list stays current. Each Box line names the gates key that decides its human pause, and the qa line states when it merges. AGENTS.md puts both READMEs in the rule's scope. Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…mmands and Boxes

Drop the contract B and C labels, state the red/green rule where it stood alone, drop the bare (measured) asides, and give the reasons two Box comments had lost. Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…pgrade

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…Boxes and AGENTS.md

Refs #556

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@orioltf
orioltf merged commit 2c55bc6 into develop Oct 28, 2026
14 checks passed
@orioltf
orioltf deleted the feature/unic-archon-dlc/556-no-links-back-to-this-repo branch October 28, 2026 18:42
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.

unic-archon-dlc: ADR links in commands/*.md resolve against the Consumer's repository

1 participant