agent-bootstrap

name	agent-bootstrap
description	Use when setting up or repairing repo agent instructions for Claude Code, Codex, or both. Proposes durable AGENTS.md, CLAUDE.md, and project memory changes before writing unless setup was explicitly requested.
metadata	{"author":"allytag"}

Agent Bootstrap

Use this skill to add durable project instructions without overwriting repo intent.

When To Use

• User asks to bootstrap Claude Code, Codex, or AI agent workflow.
• Repo lacks useful AGENTS.md / CLAUDE.md and the user wants setup or repair.
• Existing instructions are stale, duplicated, unsafe, or too large.
• Long project needs small boot files plus memory docs.

Do not use for normal coding unless instructions are part of the task.

Safety Rules

1. Read existing AGENTS.md, CLAUDE.md, README, package scripts, and relevant docs first.
2. Never overwrite existing instructions blindly.
3. Preserve project-specific rules; append guarded updates when possible.
4. Keep boot files short: commands, safety rules, memory location, verification expectations.
5. Put detailed context in docs/agent-memory/, not in boot files.
6. Do not add secrets, credentials, private paths, or one-project assumptions to reusable skills.
7. If boot files or docs/agent-memory/ are missing, do not auto-create them. Propose the files, summarize each in one line, and wait for explicit approval.
8. Exception: create directly only when the user explicitly asked for project setup, agent setup, memory setup, or said to set up the repo.