Skip to content

docs: consolidate agent guidance#147

Merged
kvithayathil merged 7 commits into
mainfrom
agents/frontend-agents-consolidation
Jun 28, 2026
Merged

docs: consolidate agent guidance#147
kvithayathil merged 7 commits into
mainfrom
agents/frontend-agents-consolidation

Conversation

@kvithayathil

Copy link
Copy Markdown
Contributor

Summary

  • replace context-heavy AGENTS guidance with concise routing docs
  • add local agent hook scripts and platform hook configs
  • consolidate frontend/backend agent overlays with focused commands, structure, conventions, and boundaries

Verification

  • pre-commit hooks passed during commit
  • confirmed listed backend just commands exist
  • ran opencode config validation successfully

Move durable agent guidance into docs/agents/, add self-learning loop,
portable hook scripts under .agents/hooks/scripts/, and ignore
machine-local preferences under .agents/local/.
Add SessionStart hook configs for Claude Code, VS Code, Cursor, Codex,
and OpenCode that call read-local-agents-hook.sh at session start.
The wrapper script outputs JSON for cross-platform compatibility.

Add .gitignore and .gitblock exceptions for platform config files.
Single script now outputs root AGENTS.md followed by local agent
preferences. JSON output by default for hook platforms, --plain for
direct execution. Adds pi-yaml-hooks config for Pi platform.
Path resolution now goes through agents_dir instead of counting
../../.. from script location. Works at repo root or worktree.
@kvithayathil kvithayathil requested review from a team as code owners June 28, 2026 00:49
@kvithayathil kvithayathil merged commit b1af09b into main Jun 28, 2026
14 checks passed
@kvithayathil kvithayathil deleted the agents/frontend-agents-consolidation branch June 28, 2026 01:14
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