| name | orient-agent |
| description | Load the always-required baseline context before any implementation, planning, or documentation work. Reads the glossary, loads all specs, reads AGENTS.md, the completeness doctrine, notes/README.md, and docs/adr/index.md, reads plan/incoming/learnings/, and queries Project #24 for Schedule=Now items. Run this at the start of every workflow skill before selecting or reading a specific issue. Replaces study-project-docs Phase A.
|
Skill: Orient Agent
Procedure
Step 1 — Read the ubiquitous language glossary
Read docs/reference/glossary.md.
Step 2 — Load specs
Run PYTHONPATH= uv run spec-dump 2>&1. Capture the output. Do not read raw
specs/*.yaml files directly.
Step 3 — Read agent rules, completeness doctrine, active notes index, and ADR index
Read in parallel:
AGENTS.md — agent rules, conventions, and pitfalls.claude/skills/shared/completeness-doctrine.md — quality standard; governs what "done" meansnotes/README.md — index of active design notes (do not read individual notes files here; use deepen-context)docs/adr/index.md — overview of all ADRs; used by deepen-context to decide which ADRs to load
Step 4 — Read build observations
Read all files in plan/incoming/learnings/. Do not read plan/history/.
Step 5 — Query current priorities
bash .agents/skills/shared/query-now-epics.sh
Do not skip this skill even for small tasks. After orient-agent, invoke deepen-context with task-specific hints once the target issue is known.
