project-orientation

What problem does it solve?

This skill helps agents quickly understand where a project is, where it's going, and what needs to happen next - without reviewing the entire codebase or documentation from scratch.

Core Features & Use Cases

• Reading Project State (Orient Mode): When invoked without arguments, read and synthesize project context, including project/STATE.md, git context, and key docs (README.md, ROADMAP.md, docs/), and present a concise summary.
• Updating Project State (Update Mode): When invoked with --update or after a commit, gather context, update project/STATE.md with history, current focus, next steps, decisions, blockers; keep it concise.
• File Format: The project/STATE.md structures the human- and LLM-readable state with sections for Current Focus, Recent Completions, Next Steps, and more.

Quick Start

Invoke /project-orientation to read the current project state and present a concise, actionable summary for continuity.