**Organization patterns and templates for AI coding agents**
Sign in to like and favorite skills
Organization patterns and templates for AI coding agents
Standardized structure for AI working context. Use to set up any project with ai/ context management.
For complete guidance: @PATTERNS.md
Core pattern:
tk.tasks/agent-contexts/ ├── README.md # Quick start (humans + AI) ├── PATTERNS.md # Detailed patterns (AI reference) ├── AGENTS.md # This file ├── CLAUDE.md # Symlink → AGENTS.md ├── global/ │ └── CLAUDE.md # Template → ~/.claude/CLAUDE.md or project config ├── agents/ # Reference subagent implementations │ ├── researcher.md │ ├── designer.md │ ├── developer.md │ ├── reviewer.md │ └── profiler.md └── skills/ ├── setup-ai.md # Initialize AI context for project ├── save.md # Save session state before compact ├── sprint.md # Break specs into sprints and tasks ├── review.md # Code review with parallel subagents ├── refactor.md # Analyze and suggest refactorings ├── profile.md # Deep performance analysis ├── prune.md # Clean up cruft and organize ai/ ├── writer.md # Review text for AI patterns └── creating-skills.md # Turn techniques into reusable skills
| File | When | Purpose |
|---|---|---|
| STATUS.md | Always | Current state, blockers (read FIRST) |
| DESIGN.md | Recommended | System architecture, components |
| DECISIONS.md | Recommended | Architectural decisions |
| ROADMAP.md | Situational | Phases, milestones (multi-phase only) |
Subdirectories (on demand):
For context isolation, parallelism, fresh perspective. ai/ files are shared memory.
| Agent | Purpose | Persists to |
|---|---|---|
| External knowledge, synthesis | ai/research/ |
| Architecture, planning | ai/design/ |
| Well-scoped implementation | — |
| Full validation (build/run/test) | ai/review/ |
| Deep performance analysis | ai/review/ |
See
agents/One project: Read PATTERNS.md, apply patterns to target project
All projects: Copy
global/CLAUDE.md/setup-ai