Skip to content

docs: condense AGENTS.md to verified, current knowledge - #128

Merged
Bre77 merged 1 commit into
mainfrom
fm/agentsmd-typescript-teslemetry
Sep 2, 2026
Merged

Bre77 merged 1 commit into
mainfrom
fm/agentsmd-typescript-teslemetry

Conversation

@Bre77

@Bre77 Bre77 commented Sep 2, 2026

Copy link
Copy Markdown
Member

Intent

  • AGENTS.md had accreted to 29,888 bytes, much of it duplicating what the repo already shows. Rewritten to 16,428 bytes (-45%) so it stays worth reading in full at the top of every agent session.
    • Every retained claim was checked against the current source before keeping it — file paths, scripts, config keys, service/subType wiring, CI job structure. Nothing was kept on faith; nothing verified was dropped.
    • Removed: the ASCII directory tree, per-package source-file and node/operation inventories (the file itself already warned these go stale), the duplicate "Key Architecture Decisions" / "Important Files" sections restating facts stated elsewhere, generic upstream doc links, and narrative about the Homebridge package superseding the legacy hand-published one — its still-load-bearing part (publishing needs npm trusted publishing registered) is kept as one line.
    • Preserved verbatim in substance: all "must never/must always" contracts — token-in-query-string log stripping, super.on() ordering, contact-sensor polarity, subType collision rules, the null vs undefined tariff distinction, the needs: validate publish gate, and the pnpm/action-setup version-sync rule.
    • Kept the ## Maintaining this file self-governance section so the next pass has the same bar.

Docs-only; no code touched. pnpm lint clean and pnpm test green (nothing references the removed content programmatically).

🤖 Generated with Claude Code

https://claude.ai/code/session_012ZzhkTRstc5jp6h7aN9g2a

Every retained claim was checked against the current source; the file drops
content the codebase already shows and keeps the non-obvious invariants.

Claude-Session: https://claude.ai/code/session_012ZzhkTRstc5jp6h7aN9g2a
@Bre77 Bre77 added the fm Opened by a Firstmate crewmate label Sep 2, 2026
@Bre77
Bre77 merged commit 4ffe35d into main Sep 2, 2026
2 checks passed
Bre77 added a commit that referenced this pull request Sep 21, 2026
Every retained claim was checked against the current source; the file drops
content the codebase already shows and keeps the non-obvious invariants.

Claude-Session: https://claude.ai/code/session_012ZzhkTRstc5jp6h7aN9g2a
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fm Opened by a Firstmate crewmate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant