Skip to content

docs(aidd-context): let rule generation cover OpenCode V1 - #1009

Merged
blafourcade merged 3 commits into
nextfrom
docs/opencode-v1-agents-md
Oct 12, 2026
Merged

blafourcade merged 3 commits into
nextfrom
docs/opencode-v1-agents-md

Conversation

@blafourcade

@blafourcade blafourcade commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

🎯 What & why

The rule contract excluded OpenCode V1, yet the rules it writes for OpenCode go into the root AGENTS.md, which V1 reads too. OpenCode's rules documentation says: "Place an AGENTS.md in your project root for project-specific rules". Config instructions are only combined with that file.

🛠️ How it works

  • tool-paths.md:
    • the OpenCode row names OpenCode with no version;
    • "This contract excludes OpenCode V1" becomes one instruction: "OpenCode: write the root AGENTS.md only, never .opencode/rules.";
    • the OpenCode rules documentation joins the contract links;
    • the date on that line is removed.
  • 03-validate.md: the shared-contribution check names OpenCode rather than OpenCode V2.
  • .claude/rules/01-standards/2-tracker-ids.md: No dates or ticket/run IDs in code, comments, tests, CI or docs.

⚠️ Heads-up

This rests on OpenCode's documentation alone: no OpenCode 1.x session has been run against a generated rule.

🔗 Linked issue

Closes #913

✅ I certify

  • I DO CERTIFY I READ EACH LINE OF THE PULL REQUEST BECAUSE I AM A SOFTWARE ENGINEER, NOT A AI PUPPY.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VE16AxC1V9wAMGmGgefe4z

The rule contract excluded OpenCode V1, yet the contribution it writes for
OpenCode is the root `AGENTS.md`, and OpenCode V1's rules documentation reads
that file: "Place an AGENTS.md in your project root for project-specific
rules", with config `instructions` only combined with it. The OpenCode row now
covers V1 and V2, and the V1 documentation joins the checked contracts.

This rests on the documentation: no OpenCode 1.x session has been run against
a generated rule.

Closes #913

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01VE16AxC1V9wAMGmGgefe4z
@blafourcade
blafourcade requested a review from a team as a code owner October 12, 2026 14:08
blafourcade and others added 2 commits October 12, 2026 17:13
Both OpenCode versions read the root `AGENTS.md`, so the row and the sentence
under the table name OpenCode alone, and the checked-contracts line loses its
date. The tracker-ID rule now also keeps dates out, and covers docs.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01VE16AxC1V9wAMGmGgefe4z
The sentence listing what OpenCode does not read named three formats a
generator could pick back up. It now says only where to write and the one
wrong target the contract used to name, `.opencode/rules`.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01VE16AxC1V9wAMGmGgefe4z
@blafourcade
blafourcade merged commit fd82072 into next Oct 12, 2026
25 checks passed
@aidd-bot aidd-bot Bot mentioned this pull request Oct 16, 2026
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.

1 participant