Skip to content

chore(specs): tighten the agnostic-ai specs - #1426

Draft
Chemaclass wants to merge 1 commit into
mainfrom
chore/1396-tighten-agnostic-ai-specs
Draft

Chemaclass wants to merge 1 commit into
mainfrom
chore/1396-tighten-agnostic-ai-specs

Conversation

@Chemaclass

Copy link
Copy Markdown
Member

Background

Related #1396

The agnostic-ai specs had drifted from CI and the repo, loaded a stale module table on every src/ edit, and the issue skills were shadowed by global skills of the same name. This PR does the parts that work on the pinned agnostic-ai 0.87.0. Three items still need work, listed below.

Changes

  • Gate is make test, make test/strict, make sa, make lint, matching CI's strict job. The gate, commit types and the shfmt -w warning each live in one spec file.
  • Issue skills renamed to bashunit-gh-issue and bashunit-gh-issues; doctor --scope project reports no findings.
  • Module table moved to skills/fork-census/references/module-map.md, with stale and missing rows fixed (reports/, Cobertura, awk rules, diff coverage, sandbox, suites, benchmark files). Return slots moved to rules/return-slots.md, so test edits no longer load them.
  • pr labels and fix-test fixture path now exist. Snapshot edits ask first. Lint budgets added. Session-wide model: balanced pin removed; per-agent tiers stay. The after-edit hook falls back to agnostic-ai on PATH and exits 0 without it.

Sizes from agnostic-ai explain --context, before and after:

Measure Before After Target
Claude startup 709 words 492 words 500
Claude src/ edit, extra rules 1,973 words 1,050 words 1,200
Codex root AGENTS.md 4,173 bytes 2,505 bytes 3 KB
Codex src/ chain 19,354 bytes 10,727 bytes 24 KB

Validation: npm run agents:check passes, lint --strict is clean, and doctor --scope project has no findings. The hook exits 0 in a clone without node_modules and without agnostic-ai on PATH. make sa and make lint pass. I stopped make test/strict before it finished; this PR does not touch src/ or tests/, so CI's run decides.

Still missing

Checklist

  • I updated the CHANGELOG.md to reflect the new feature or fix
  • I updated the documentation to reflect the changes

Claude startup drops from 709 to 492 words, a src/ edit loads 1,050
words of rules instead of 1,973, and the Codex root AGENTS.md drops
from 4,173 to 2,505 bytes.

- Gate runs make test, make test/strict, make sa, make lint, as CI does
- Rename the issue skills to bashunit-gh-issue and bashunit-gh-issues
- Move the module table to a fork-census reference and fix stale rows
- Move return slots out of the tests/** scope into their own rule
- One home each for the gate, commit types and the shfmt warning
- Fix the pr labels and the fix-test fixtures path
- Ask before editing acceptance snapshots
- Add lint budgets; drop the session-wide model pin
- Hook falls back to agnostic-ai on PATH and exits 0 without it

Refs #1396
@Chemaclass Chemaclass added the refactoring Refactoring or cleaning related label Oct 28, 2026
@Chemaclass Chemaclass self-assigned this Oct 28, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

refactoring Refactoring or cleaning related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant