Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By orban
Hierarchical AGENTS.md infrastructure for AI-navigable codebases. Create CLAUDE.md/AGENTS.md files that help AI agents navigate your codebase like senior engineers.
npx claudepluginhub orban/intent-layer --plugin intent-layer> 4 specialized subagents. Markdown files with YAML frontmatter (`description`, `capabilities`) that Claude auto-invokes for analysis tasks.
Find drift between Intent Layer nodes and current code state. Use for quarterly maintenance, post-merge review, or when hook flags accumulate.
Identifies Intent Layer nodes affected by code changes for targeted validation
Analyze a directory and propose AGENTS.md content. Use when setting up new Intent Layer nodes or when a directory is flagged as needing coverage.
Deep validation that an Intent Layer node accurately reflects its codebase. Use after creating/updating nodes or as part of PR review.
End-of-cycle learning capture and triage. Run after completing a feature, fixing a bug, or finishing any significant work. Reviews pending learnings, analyzes conversation for undocumented insights, and integrates into the Intent Layer with appropriate scope (global workflow vs local code).
Quick health check for Intent Layer - validates nodes, checks staleness, reports coverage gaps
Use when maintaining an existing Intent Layer, during quarterly reviews, after significant code changes, when something confused you, or when user asks to audit/update CLAUDE.md or AGENTS.md files.
Get oriented in an unfamiliar codebase using its Intent Layer. Use when joining a new project, exploring a codebase for the first time, or helping someone understand "where do I start?" questions.
Query the Intent Layer to answer questions about the codebase. Use when asking "what owns X?", "where should I put Y?", "what constraints apply to Z?", or navigating an unfamiliar codebase using its AGENTS.md hierarchy.
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Make a codebase agent-ready by scaffolding AGENTS.md, ARCHITECTURE.md, and docs/ structure following progressive disclosure patterns. Creates CLAUDE.md as a symlink for Claude Code compatibility.
Harness for Claude Code — skills, /harness:* slash commands, persona subagents, lifecycle hooks, and MCP tools without per-repo `harness setup`. Sibling plugins exist for Cursor, Gemini CLI, and Codex.
Generate and maintain AGENTS.md, copilot-instructions.md, and other agent rule files
Persistent memory, shared standards, and structured workflows for AI coding agents. Detects project setup and injects agent context automatically.
Unified capability management center for Skills, Agents, and Commands.
The operational layer for coding agents. Bookkeeping, validation, and flows that compound knowledge between sessions.
Personal skills collection - thinking techniques, debugging patterns, and process workflows
MCP server for MX3 Fitness gym booking at Noe Valley. Check schedules, book slots, cancel reservations, and view credits.
Uses power tools
Uses Bash, Write, or Edit tools
Uses power tools
Uses Bash, Write, or Edit tools
Share bugs, ideas, or general feedback.
Claude Code plugin for creating and maintaining Intent Layer infrastructure.
Intent Layers solve a fundamental problem: AI agents reading raw code lack the tribal knowledge that experienced engineers have.
Senior engineers know:
Intent Layers compress this knowledge into high-signal AGENTS.md/CLAUDE.md files that give agents the same intuition—without reading thousands of lines of code.
# Add the marketplace
/plugin marketplace add orban/intent-layer
# Install the plugin
/plugin install intent-layer@orban
Or using the CLI:
claude plugin marketplace add orban/intent-layer
claude plugin install intent-layer@orban
# Clone the repository
git clone https://github.com/orban/intent-layer.git
# Install from local path
claude plugin install ./intent-layer
Interactive workflows invoked via slash commands:
| Skill | Purpose | Command |
|---|---|---|
intent-layer | Set up new Intent Layer infrastructure | /intent-layer |
intent-layer-maintenance | Maintain existing Intent Layers | /intent-layer-maintenance |
intent-layer-onboarding | Orient new developers using Intent Layer | /intent-layer-onboarding |
intent-layer-query | Query Intent Layer for answers | /intent-layer-query |
review-mistakes | Interactive review of pending mistake reports | /review-mistakes |
Specialized subagents that Claude invokes automatically when appropriate:
| Agent | Purpose |
|---|---|
explorer | Analyze directories and propose AGENTS.md content |
validator | Deep validation that nodes accurately reflect codebase |
auditor | Find drift between nodes and current code state |
Automatic event handlers that keep the Intent Layer active during development:
| Hook | Event | Purpose |
|---|---|---|
post-edit-check | PostToolUse | Remind about Intent Layer coverage after Edit/Write/NotebookEdit |
pre-edit-check | PreToolUse | Inject pitfalls before edits, warn about uncovered dirs |
inject-learnings | SessionStart | Inject recent learnings, suggest setup if no Intent Layer |
capture-tool-failure | PostToolUseFailure | Auto-create skeleton mistake reports on Edit/Write/NotebookEdit/file-modifying Bash failures |
| Stop prompt | Stop | LLM evaluates session for learnings to capture |
Canonical hook-slot taxonomy lives in hooks/hooks.json for config and hooks/AGENTS.md for payload contracts. matcher values are tool names within a slot, not extra hook events.
The plugin implements a continuous, mostly-automated learning loop:
Agent makes mistake → PostToolUseFailure auto-creates skeleton
↓
Skeleton in .intent-layer/mistakes/pending/
↓
Stop hook evaluates: enrich or discard?
↓
Next session: Agent offers interactive review
or user runs /review-mistakes
↓
User decides: Accept / Reject / Discard
↓ (on accept)
Auto-integrated via lib/integrate_pitfall.sh
Pitfall added to covering AGENTS.md
↓
Next session: SessionStart injects learnings
↓
PreToolUse injects relevant pitfalls before edits
Interactive review: When pending reports exist, the agent offers to walk you through them conversationally. You can also explicitly run /review-mistakes to start a review session.
Supporting scripts:
| Script | Purpose |
|---|---|
lib/integrate_pitfall.sh | Auto-add pitfalls to covering AGENTS.md |
scripts/capture_mistake.sh | Manual capture (if auto-capture missed something) |
scripts/review_mistakes.sh | Terminal-based review (alternative to agent) |
# Check if Intent Layer exists
./scripts/detect_state.sh /path/to/project
# Analyze token distribution
./scripts/estimate_all_candidates.sh /path/to/project
# Create nodes using the skill
# Then in Claude Code: /intent-layer /path/to/project