Sync §5.7 Agent Context Files — Standard v1.46 - #33
Conversation
spacecraft-standard-constitution: adds §5.7 (AGENTS.md is the authority, CLAUDE.md is an @AGENTS.md import plus Claude-only content), the §16 checklist bullet, the spacecraft-agentic-cli cross-reference row, and the v1.46 changelog entry. Masthead and frontmatter to v1.46 / 2026-08-08; description measures 988 chars under the §5.6 cap. spacecraft-agentic-cli: inverts the rule this skill previously taught. references/agents-md-authoring.md §1 and §3 said "CLAUDE.md MUST be a strict superset of AGENTS.md. Start by symlinking or copying" — a rule that produced duplication by construction and that every new scaffold reproduced. Both assets/ templates rewritten to the import model; CLAUDE.md length budget cut from 100-250 to 5-40 lines. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The maintainer-local CLAUDE.md overlay (444 lines) becomes the tracked, authoritative AGENTS.md; the old 45-line AGENTS.md digest is folded into it so the hard rules survive in one place. CLAUDE.md is now the @AGENTS.md import plus two Claude-Code-only notes. Both leave .gitignore. The file was read end to end and reviewed for sensitive content first: the Home Manager fan-out section describes `~/`-relative and /nix/store paths only, with no credentials, hostnames, or personal filesystem paths. construct-cli's byte-identical pair is collapsed the same way. Steelbore Standard v1.46 §5.7. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: a637c57524
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| | `AGENTS.md` | **Every** agent (Codex CLI, Cursor, Aider, OpenCode, and Claude Code via the import) | **Authoritative.** Coding conventions, test/build commands, forbidden patterns, repository invariants | | ||
| | `CLAUDE.md` | Claude Code agent | An `@AGENTS.md` import plus Claude-only context (skills, `.claude/`, slash commands, MCP client) — never a restatement of AGENTS.md | |
There was a problem hiding this comment.
For users who install spacecraft-agentic-cli.zip or .skill, both unchanged bundles still contain the old guidance that CLAUDE.md should duplicate AGENTS.md; they also omit all four updated source/reference/template files in this commit. Rebuild and commit both bundles so the install surface actually delivers the policy introduced here.
AGENTS.md reference: AGENTS.md:L406-L409
Useful? React with 👍 / 👎.
| If the user mentions "Spacecraft Software", a Spacecraft Software subproject name, or asks you to work on | ||
| anything in the Spacecraft Software ecosystem, consult this skill immediately. It encodes | ||
| The Steelbore Standard v1.45 (§13 design systems; §3.1.1 TypeScript over JS; §6.4 contribution targets; §5.6 skill packaging; §11 palettes + §11.6 system theme; §18 accessibility; §17 progress reporting; §3.2 compiler flags; concurrency; §3.3 security-by-design) so | ||
| The Steelbore Standard v1.46 (§13 design systems; §3.1.1 TypeScript; §5.7 AGENTS.md; §6.4 contribution targets; §5.6 skill packaging; §11 palettes + §11.6 system theme; §18 accessibility; §17 progress reporting; §3.2 compiler flags; concurrency; §3.3 security-by-design) so |
There was a problem hiding this comment.
For consumers installing spacecraft-standard-constitution.zip or .skill, both unchanged archives still identify themselves as Standard v1.44 and contain no §5.7, despite the source now advertising v1.46. Rebuild both bundles with the modified SKILL.md and changelog before shipping this governance update.
AGENTS.md reference: AGENTS.md:L406-L409
Useful? React with 👍 / 👎.
| Anything that is true of the *project* goes in AGENTS.md. Only what a | ||
| non-Claude harness cannot act on belongs here: |
There was a problem hiding this comment.
When authors follow this canonical example, the subsequent Tool preferences entries and the TODO(claude) source convention are placed only in CLAUDE.md, although Codex and other harnesses also need those project-wide rules. Remove those generic entries from the overlay example or move them into its AGENTS.md example so the reference does not contradict the new single-source rule.
AGENTS.md reference: AGENTS.md:L434-L436
Useful? React with 👍 / 👎.
| none is repeated here to go stale. Load it before any non-trivial edit — its §14 checklist is the | ||
| audit gate. The skill is the upstream of the published `standard/` document; |
There was a problem hiding this comment.
The constitution added by this commit explicitly names §16 as its compliance checklist, while this authoritative context directs agents to a nonexistent §14 checklist; §14 is the date/time section. Agents following the mandatory pre-edit instruction can therefore skip the actual audit gate, so change this reference to §16.
AGENTS.md reference: AGENTS.md:L47-L52
Useful? React with 👍 / 👎.
1 participant
Construct-side sync of Standard v1.46 §5.7 — Agent Context Files (Spacecraft-Software/Standard#26).
AGENTS.mdbecomes the single authoritative context file in every project;CLAUDE.mdbecomes an@AGENTS.mdimport plus only what is meaningless to a non-Claude harness.This inverts guidance previously carried only in
spacecraft-agentic-cli, which instructed authors to makeCLAUDE.mda strict superset ofAGENTS.mdand to start by symlinking or copying it — a rule that produced the duplication by construction and that every new scaffold reproduced. That skill'sreferences/agents-md-authoring.mdand bothassets/templates are rewritten to match.The cross-reference gate will fail:
Pre-existing in commit
ebcaa65on this branch, not introduced by the stacked v1.47 PR. It needs a one-line edit to cite §5.7 rather than pin v1.46. I have deliberately not changed it — it is your authored content and you may prefer your own wording. Say the word and I will push the fix.Base of a stack
PR 1 of 2 in Construct. The v1.47 §17 sync is based on this branch and should merge after it.
🤖 Generated with Claude Code