osx-concepts

# OpenSpec-extended for AI Agents Framework reference for OpenSpec-extended. Covers the framework (repo layout, artifacts, resource taxonomy, glossary) and decision guidance. --- ## TL;DR — mental model in 30 seconds **What OpenSpec-extended is**: a spec-driven development framework where you agree on **WHAT** to build before writing code. All artifacts live in the repository so humans and AI can collaborate. **Skill split** (read both): 1. **This skill (`osx-concepts`)** — framework, repo layout, 4 artifacts, delta specs, resource taxonomy, decision guidance, glossary 2. **`osx-workflow`** — 4 tool layers (`openspec`, `openspec-extended`, `osx` CLI, `osx` lib) and the 7-phase autonomous loop driven by `openspec-extended orchestrate` **Skip OpenSpec when**: 1-2 line fix, emergency hotfix, pure debugging. --- ## §1 Philosophy Traditional workflows pretend work is linear (plan → implement → done). Real work isn't: you implement, realize the design is wrong, update specs, continue. **OpenSpec uses fluid actions, not rigid phases** — skills are things you can do anytime. | Principle | Meaning | |-----------|---------| | **Fluid not rigid** | No phase gates — work happens iteratively | | **Iterative not waterfall** | Learn as you build; refine as you go | | **Easy not complex** | Minimal ceremony; get started in seconds | | **Brownfield-first** | Works with existing code; most work modifies systems | --- ## §2 The Framework ### 2.1 Repository layout ``` openspec/ ├──...