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.

examples/coverage-plan.md

View on GitHub
# Coverage Plan Example

## Repo

`utility-modules/opensite-ui`

## Root AGENTS.md should cover

- library mental model
- tree-shaking rules
- block registry behavior
- style token and Tailwind conventions
- shared verification commands

## Nested AGENTS.md should exist for

- `components/blocks/`
  - distinct JSON-serializable block props
  - semantic builder compatibility
  - registry and export-generation rules

## Nested AGENTS.md probably not needed for

- thin utility folders that inherit the same tree-shaking and styling rules without adding local constraints

## Why this is a good split

- The root file stays broadly useful across the repo.
- The nested file captures block-specific rules that would otherwise bloat the root.
- Agents touching `components/blocks/*` get the stronger local guidance automatically.
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