[mBukator]

🎯 Overview

Track the agent guidance for this repo, using the layout the sibling repos (atsume, kuhaku) already use. AGENTS.md is the tool-agnostic source of truth. CLAUDE.md is a thin file that imports it and indexes the path-scoped rules. Until now, none of this was tracked, and CLAUDE.md @-imported every rule and guide, about 159 KB per session.

✨ Changes

Agent docs

• AGENTS.md (new):
  • Project overview, layer rules and security invariants
  • Code conventions, commands, CI gates and git flow
  • Node >=22.13.0, which matches engines
• CLAUDE.md:
  • Now @AGENTS.md plus a rule index written as plain paths.
  • Rules load only when their paths: glob matches.
• .claude/rules:
  • Added paths: frontmatter to code-style.md.
  • documentation.md frontmatter keeps only paths, and its mappings now point to docs/reference/*.
  • Dropped the @-imports in Resources sections.
• .claude/guides:
  • Hook docs now match .husky/: lint-staged, type-check, and the pre-push hook.
  • Gate lists now include knip and the prettier check.
  • Feature PR examples use --base develop.
  • The AI-attribution guidance no longer contradicts itself.
• .claude/maintenance:
  • Kept only codebase-map.md, with refreshed counts and the theme files added.
  • Dropped the review-schedule and staleness tracker.

Shared settings

• .claude/settings.json (new):
  • Allow list for the gate commands.
  • Deny list for --no-verify, force pushes (including + refspecs) and pushes to main or develop.
  • Personal settings.local.json stays ignored.

🔧 Technical Details

Docs and config only, with no changes to src/ or tests/. The files stay out of the npm tarball (npm pack --dry-run shows none of them), because files is a whitelist. Prettier ran with embedded code formatting off, so the intentional "BAD" code examples in the rules are unchanged.

📋 Testing

npm run lint && npm run type-check && npm run knip && npm run test && npm run build
npx prettier --check "src/**/*.ts" "tests/**/*.ts" "docs/**/*.md"

All pass locally: 21 test files and 568 tests.

✅ Checklist

• Code follows project coding standards
• Self-review completed
• Tests added/updated and passing (no code changes)
• Documentation updated (if needed)
• No new warnings introduced
• Commit messages follow conventional commits