48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
|
# Drop-In Agent Instruction Suite
|
||
|
|
|
||
|
|
This repository is a portable markdown instruction pack for coding agents.
|
||
|
|
|
||
|
|
Copy these files into another repository to give the agent:
|
||
|
|
- a root `AGENTS.md` entrypoint,
|
||
|
|
- a central skill index,
|
||
|
|
- category hubs for routing,
|
||
|
|
- specialized skill files for common software, docs, UX, marketing, and ideation tasks.
|
||
|
|
|
||
|
|
## Structure
|
||
|
|
|
||
|
|
- `AGENTS.md` - base instructions and routing rules
|
||
|
|
- `DEPLOYMENT-PROFILE.md` - agent-readable prefilled deployment defaults
|
||
|
|
- `INSTALL.md` - copy and customization guide for other repositories
|
||
|
|
- `PROJECT-PROFILE-WORKBOOK.md` - one-time questionnaire for staging defaults
|
||
|
|
- `SKILLS.md` - canonical skill index
|
||
|
|
- `ROUTING-EXAMPLES.md` - representative prompt-to-skill routing examples
|
||
|
|
- `hubs/` - category-level routing guides
|
||
|
|
- `skills/` - specialized reusable skill files
|
||
|
|
|
||
|
|
## Design Goals
|
||
|
|
|
||
|
|
- Plain markdown only
|
||
|
|
- Cross-agent portability
|
||
|
|
- Implementation-first defaults
|
||
|
|
- On-demand skill loading instead of loading everything every session
|
||
|
|
- Context-efficient routing for large skill libraries
|
||
|
|
- Prefilled deployment defaults without per-install questioning
|
||
|
|
- Repo-local instructions take precedence over this bundle
|
||
|
|
|
||
|
|
## Intended Workflow
|
||
|
|
|
||
|
|
1. The agent reads `AGENTS.md`.
|
||
|
|
2. The agent reads `DEPLOYMENT-PROFILE.md` when it is filled in.
|
||
|
|
3. The agent checks `SKILLS.md`.
|
||
|
|
4. The agent opens only the relevant hub and skill files for the task.
|
||
|
|
5. The agent combines multiple skills when the task spans several domains.
|
||
|
|
|
||
|
|
## Core Categories
|
||
|
|
|
||
|
|
- Software development
|
||
|
|
- Debugging
|
||
|
|
- Documentation
|
||
|
|
- UI/UX
|
||
|
|
- Marketing
|
||
|
|
- Brainstorming
|