Skip to content

feat: inline imperative instructions in CLAUDE.md/AGENTS.md#190

Merged
abhigyanpatwari merged 1 commit into
mainfrom
feat/inline-agents-md
Mar 6, 2026
Merged

feat: inline imperative instructions in CLAUDE.md/AGENTS.md#190
abhigyanpatwari merged 1 commit into
mainfrom
feat/inline-agents-md

Conversation

@abhigyanpatwari

Copy link
Copy Markdown
Owner

Summary

  • Replaces passive skill router table in generated CLAUDE.md/AGENTS.md with direct enforcement instructions
  • Uses RFC 2119 language (MUST, NEVER, ALWAYS) proven to change model behavior
  • Three-tier Always/When/Never boundary structure based on research from 2,500+ repos
  • Self-check checklist forcing model to verify its own work before finishing
  • ~77 lines, well within the <150 line adherence sweet spot

Why

Vercel eval data shows skills are skipped 56% of the time — inline instructions achieve 100% pass rate. The previous router approach ("read this skill file") added an extra step that models frequently skipped. User feedback (Stephen/Neura project) confirmed models silently skip tool calls without mandatory rules.

What Changes for Users

After npx gitnexus analyze, the generated CLAUDE.md/AGENTS.md will contain:

  • Always Do — MUST rules with exact tool commands (impact before edit, detect_changes before commit)
  • When Debugging — 4-step workflow inline
  • When Refactoring — rename/extract safety procedures
  • Never Do — hard prohibitions
  • Tools Quick Reference — one-liner per tool with example
  • Self-Check — verification checklist

Skills are still installed as bonus depth for Claude Code's skill system.

Test plan

  • All 749 unit tests pass
  • TypeScript builds clean
  • ai-context.test.ts specifically passes (marker upsert, no duplication)

🤖 Generated with Claude Code

…tions

CLAUDE.md and AGENTS.md now contain direct enforcement instructions instead
of a passive skill router table. Based on Vercel eval data showing skills
are skipped 56% of the time, and industry research on effective AGENTS.md
patterns from 2,500+ repos.

Key changes:
- Always/When/Never three-tier boundary structure
- RFC 2119 language (MUST, NEVER) for critical rules
- Exact tool commands with parameters inline
- Self-check checklist forcing model to verify its own work
- ~77 lines, well within the <150 line adherence threshold

Skills are still installed as bonus depth for Claude Code's skill system.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel

vercel Bot commented Mar 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
gitnexus Building Building Preview, Comment Mar 6, 2026 7:17am

Request Review

@abhigyanpatwari abhigyanpatwari merged commit 84ef652 into main Mar 6, 2026
7 of 8 checks passed
abhigyanpatwari added a commit that referenced this pull request Mar 6, 2026
Regenerated CLAUDE.md and AGENTS.md using gitnexus@1.3.9 which replaces
the old skill-router format with inline imperative instructions (PR #190).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
CrazyBunQnQ pushed a commit to CrazyBunQnQ/GitNexus that referenced this pull request Mar 8, 2026
…tions (abhigyanpatwari#190)

CLAUDE.md and AGENTS.md now contain direct enforcement instructions instead
of a passive skill router table. Based on Vercel eval data showing skills
are skipped 56% of the time, and industry research on effective AGENTS.md
patterns from 2,500+ repos.

Key changes:
- Always/When/Never three-tier boundary structure
- RFC 2119 language (MUST, NEVER) for critical rules
- Exact tool commands with parameters inline
- Self-check checklist forcing model to verify its own work
- ~77 lines, well within the <150 line adherence threshold

Skills are still installed as bonus depth for Claude Code's skill system.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
CrazyBunQnQ pushed a commit to CrazyBunQnQ/GitNexus that referenced this pull request Mar 8, 2026
Regenerated CLAUDE.md and AGENTS.md using gitnexus@1.3.9 which replaces
the old skill-router format with inline imperative instructions (PR abhigyanpatwari#190).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
motolese pushed a commit to motolese/GitNexus that referenced this pull request Apr 23, 2026
…tions (abhigyanpatwari#190)

CLAUDE.md and AGENTS.md now contain direct enforcement instructions instead
of a passive skill router table. Based on Vercel eval data showing skills
are skipped 56% of the time, and industry research on effective AGENTS.md
patterns from 2,500+ repos.

Key changes:
- Always/When/Never three-tier boundary structure
- RFC 2119 language (MUST, NEVER) for critical rules
- Exact tool commands with parameters inline
- Self-check checklist forcing model to verify its own work
- ~77 lines, well within the <150 line adherence threshold

Skills are still installed as bonus depth for Claude Code's skill system.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
motolese pushed a commit to motolese/GitNexus that referenced this pull request Apr 23, 2026
Regenerated CLAUDE.md and AGENTS.md using gitnexus@1.3.9 which replaces
the old skill-router format with inline imperative instructions (PR abhigyanpatwari#190).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant