Skip to content

opensite-ai/opensite-skills / agent-file-engine

agent-file-engine

Verified

Repository-specific AGENTS.md authoring and maintenance workflow. Use when creating, refreshing, or expanding AGENTS.md coverage for a codebase, including deciding whether nested AGENTS.md files are needed for subsystems with distinct rules, workflows, or AI-sensitive constraints.

templates/root-agents.md

View on GitHub
# AGENTS.md - Instructions for coding agents working on `<repo>`

This file is for AI coding agents and maintainers. It captures the non-obvious rules, architecture, and workflows of this codebase so automated changes stay safe and consistent.

When in doubt, favor: `(1) ... , (2) ... , (3) ...`.

## 1. Quick mental model

- What the repo is
- Who consumes it
- How it is organized
- The main data or control flow

## 2. Golden rules

1. Rule with strong consequence
2. Rule about contracts or architecture
3. Rule about performance, security, or verification

## 3. Key directories

- `src/...` - purpose
- `app/...` - purpose
- `components/...` - purpose

## 4. Common workflows

### 4.1 Modify existing code

- Where to start
- What to preserve
- What commands to run

### 4.2 Add new code

- Which existing patterns to copy
- Which registries, exports, or routes must be updated

## 5. Verification

- `...`
- `...`

## 6. Additional agent docs

- See `path/to/nested/AGENTS.md` for subtree-specific rules.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall