repo-onboarding
Repository onboarding and agent bootstrap. Use at the start of a new repo session or before any task to load AGENTS.md, architecture/skills indexes, and discover local Codex skills.
When & Why to Use This Skill
The Repo Onboarding skill is an essential bootstrap utility designed to synchronize AI agents with a new codebase. It automates the initialization process by indexing repository governance (AGENTS.md), architectural frameworks, and local Codex skills. By establishing a comprehensive context of the project's 'Golden Path' and available tools before any tasks are executed, it ensures that the agent operates with high precision and adheres to project-specific standards.
Use Cases
- New Project Session: Use at the start of a session to quickly familiarize the AI agent with a complex or unfamiliar repository structure.
- Automated Skill Discovery: Automatically scan and list project-specific Codex skills located in the skills/ directory to extend agent capabilities.
- Architecture Alignment: Ensure the agent reads and follows architecture.md and related documentation to maintain design consistency during code generation.
- Governance Compliance: Load AGENTS.md to enforce repository-specific rules, constraints, and workflows before the agent performs any modifications.
- Documentation Sync: Integrate with docs-auto-sync to ensure that any code changes made by the agent are reflected in the project documentation automatically.
| name | repo-onboarding |
|---|---|
| description | Repository onboarding and agent bootstrap. Use at the start of a new repo session or before any task to load AGENTS.md, architecture/skills indexes, and discover local Codex skills. |
Repo Onboarding
Overview
Load repo governance and skills before acting.
Workflow
- Read
AGENTS.md. Follow any "Golden Path" or referenced indexes. - Load architecture references:
- If
AGENTS.mdpoints to.agent-docs/architecture.md, open it. - Otherwise open
architecture.mdand any index it references.
- Load skills references:
- Open
.agent-docs/SKILLS.mdandskills.mdif present. - Scan
skills/for*/SKILL.mdand list available Codex skills (name + path).
- Choose skills:
- If the task matches a skill description, load it and follow its workflow.
- Use
docs-auto-syncwhenever code changes are made.
- Summarize: confirm which docs/skills were loaded and any constraints found.
Resources
references/bootstrap-sources.md