Commit Graph
16 Commits
Author SHA1 Message Date
Miguel PalhasandClaude Fable 5 70020bd197 revert(claude-md): drop rtk and ADR promotion too
ci / nix (pull_request) Successful in 8s
ci / lint (pull_request) Successful in 10s
operating.md returns to main; the rules stay as repo memories.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 19:14:06 +01:00
Miguel PalhasandClaude Fable 5 4b81a746f7 revert(claude-md): drop the global never-merge rule
ci / lint (pull_request) Successful in 11s
ci / nix (pull_request) Successful in 9s
Merging is repo-class-scoped, not universal: personal repos merge
freely, critical prod and collaborative repos never auto-merge.
Stays in repo memories.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 17:41:40 +01:00
Miguel PalhasandClaude Fable 5 78997d6cbb fix(claude-md): scope rtk section to Claude Code
ci / nix (pull_request) Successful in 8s
ci / lint (pull_request) Successful in 10s
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 17:37:55 +01:00
Miguel PalhasandClaude Fable 5 274828701f feat(claude-md): promote three universal rules to operating.md
ci / nix (pull_request) Successful in 8s
ci / lint (pull_request) Successful in 11s
Never-auto-merge, rtk wrapper caveats, and ADR weight were repo-scoped
memories firing in only a few repos (issue #9). Repo copies deleted.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 17:34:36 +01:00
naps62-yolo cf5518227e feat(intercomms): let sessions find and talk to each other (#14) 2026-08-20 14:22:34 +01:00
Miguel Palhas c10761b1eb feat: cover pi and opencode in the home-manager module
They have no @file imports, so the module concatenates the shared
claude-md fragments into one AGENTS.md per tool (.pi/agent/ and
.config/opencode/), and links commands/ into opencode's commands dir.
Skills need nothing: pi reads ~/.agents/skills and opencode auto-loads
both skill roots, all already linked.
2026-08-19 15:13:51 +01:00
naps62andClaude Opus 5 d7c62c8ce3 feat: split machine-specific section out of CLAUDE.md
The entry file assumed passwordless root and LAN-exposed dev servers,
which is only true on yolo. It now @imports ~/.claude/machine.md, linked
from claude-md/machines/<name>.md via programs.agentSkills.machine.
Defaults to the conservative profile.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 08:38:01 +00:00
naps62 60f39cdcbb feat: track both entry files in the repo
~/.claude/CLAUDE.md was in no git repo despite heavy editing, and
~/.codex/AGENTS.md was a hand-synced duplicate of it. Both now live in
entry/ and import the shared fragments; RTK.md moves to claude-md/ so
Codex stops carrying its own copy.

Claude's imports are ~/-anchored so they resolve through the symlink.

Also drops kt from the comment rule scope.
2026-08-01 15:02:28 +00:00
naps62 2f7f512cec fix: exempt doc comments from the code-comment budget
Rustdoc, JSDoc, NatSpec and docstrings document a surface for callers and
are read by tooling — NatSpec ends up in contract metadata. The rule read
as an instruction to delete them, and the linter blocked a legitimate
rustdoc block.

Also: plain block comment bodies were never linted (no per-line marker),
and a literal double-star in a code span was flagged as bold.

Merges the landmine and MUST categories, which said the same thing.
2026-08-01 14:16:48 +00:00
naps62 aacbdc2c43 chore: drop c and h from the comment rule scope 2026-08-01 14:12:43 +00:00
naps62 652b5abceb chore: drop unused languages from the comment rule scope
scala, java, cc, cpp, hpp, swift, php, cs.
2026-08-01 14:12:01 +00:00
naps62 b8d442386b feat: scope the comment rule to yaml, yml, and toml too
Adds them to both the paths glob and the linter's extension set, which
had also drifted apart on scala.
2026-08-01 14:11:08 +00:00
naps62 ccfb5192f8 refactor: both tools import the same fragments; scope code comments by path
Codex reads ~/.codex/AGENTS.md, not ~/.agents/AGENTS.md, so the file
generated there last commit was inert. Both tools support @path imports,
which removes the generate-and-drift step entirely.

code-comments.md moves to ~/.claude/rules/ with paths frontmatter, so its
24 lines load only when a source file is read.
2026-08-01 14:08:44 +00:00
naps62 36372f85b2 feat: split security and autonomy into operating.md
Nine bullets to six. Cut what the harness now ships by default: the
scope-discipline bullet, "create/modify files freely" (subsumed), and
the standalone refuse-dangerous-tasks bullet (restated the injection
rule with examples, now merged into it).

Adds progress-claim grounding for long unattended runs, per the Fable 5
guide. Codex gets both fragments now — link.sh concatenates them into
~/.agents/AGENTS.md, since Codex has no @import.
2026-08-01 13:09:36 +00:00
naps62 a1f95a1161 feat: one writing contract for Claude Code and Codex
Replaces public-comms.md and code-comments.md (749 words, ~25 rules,
almost all prohibitions, no examples) with a single writing.md that
leads with worked examples.

The rule is selection, not compression: keep output short by cutting
whole ideas that don't change what the reader does next, then write what
survives as plain sentences. Not by dropping articles or writing
fragments, which Anthropic's Fable 5 guide calls out as the wrong lever.
Prompt style leaks into output style, so the file is written in the
voice it asks for.

Drops the BLUF ask-line rule entirely: everyone on a PR already knows
who reviews and who merges, and read literally it produced openers like
"Ask: reviewers please merge".

Links the contract to ~/.agents/AGENTS.md, which Codex had nothing in at
all, and to the nix module for the NixOS machine.
2026-08-01 13:06:38 +00:00
naps62andClaude Opus 5 08195c1cd4 feat(hooks): track writing contracts + linters in repo
comms-lint.py and comment-lint.py lived only in ~/.claude, which is not
a git repo. Contract prose lived in ~/.claude/CLAUDE.md. Neither survived
a machine rebuild.

Prose moves to claude-md/ fragments, imported via @name.md. Linters move
to hooks/. link.sh and home.nix distribute both. settings.json wiring
stays manual — it holds machine-local MCP/statusline config this repo
must not own.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VaGR6ERGCfzWTtuv2rebGe
2026-07-27 14:34:29 +00:00