Imported from estebanmatias92/ooad-workflow (AGENTS.md). Install upstream with npx skills add estebanmatias92/ooad-workflow. Copyright stays with the author.

AGENTS — ooad-workflow

Skills repo (not a product). Stack-agnostic distribution pack; this repo only ships skills/templates/references.

Stack

No stack assumed (agnostic). No package.json, pyproject, or runtime expected. See README.md for global symlink installation.

Structure

• skills/ — 8 skills (all disable-model-invocation: true, human calls /name): ask-ooad (router) · setup-ooad · ooad-discover · ooad-requirements · ooad-architect · ooad-build · ooad-verify · ooad-ship
• templates/ — 15 templates (PRD, SRS-830, UC, US-Gherkin, C4/UML, ADR-MADR, etc.)
• references/ — artifacts-matrix.md, definition-of-done.md, ooad-vocabulary.md (single source; human index → docs/glossary.md)
• docs/ — glossary.md (acronym/term index), dev-cycle-comparison.md + diagrams/ (pack docs); consumer docs/agents/ is generated by setup-ooad
• .tmp/ — handoffs/scratch local, ignored via .gitignore

Consumer Workflow — lifecycle order (one trigger per branch)

Human is the index — run in order, pick one branch per run (ask-ooad router cures cognitive load):

0. Bootstrap once: /setup-ooad (RUP/Waterfall/Agile + tracker + architecture)
1. Need vision/PRD? → /ooad-discover (RUP Inception + Vision)
2. PRD ready, need RE? → /ooad-requirements (IEEE 29148 + Gherkin + Fagan)
3. RE baselined, need architecture? → /ooad-architect (C4 + GoF + Clean 4 Layers)
4. Architecture approved, need code? → /ooad-build (Clean 4 Layers + TDD)
5. Code slice green, need QA? → /ooad-verify (BDD + Test Pyramid) — 4 ↔ 5 iterates per UC/US until green
6. QA green, need release? → /ooad-ship (Continuous Delivery + SRE)

Not sure? /ask-ooad. Brownfield may enter at 3. /ooad-architect with gap → US.

Each skill reads docs/agents/workflow.md for profile gating (templates/workflow.md). Shared vocabulary in references/ooad-vocabulary.md (human index: docs/glossary.md).

Conventions

• Commits in English, prefix docs: for scaffolding (docs: scaffold ooad-workflow RUP/Clean4)
• Do not version .tmp/ or .scratch/
• Global symlink: ~/.config/opencode/skills/ooad-workflow → $(pwd) (see README.md:34)
• Leading words: use tokens exactly as in ooad-vocabulary.md (no synonym drift; see docs/glossary.md for acronym expansion); descriptions front-load them
• Skill descriptions: user-invoked skills keep trigger tokens in description (intentional deviation from strict SKILL-MECHANICS one-line human summary — the global symlink exposes descriptions to model discovery, so triggers earn their load; do not strip them)

Agent Skills

Router: ask-ooad. User-invoked only — no skill fires autonomously today; composable model-invoked skills will come later. See skills/ask-ooad/SKILL.md.

Issue Tracker

This pack does not track its own issues here (distribution pack). Consumer repos choose GitHub/GitLab/Local in setup-ooad. See templates/issue-tracker-*.md.

Domain Docs

Single-context in consumer repos (CONTEXT.md + docs/adr/). See templates/domain.md.

References

• systems-analysis-ooad-paradigm.md (ES)
• artefactos-por-fase-y-metodologia.md (ES)
• docs/glossary.md — acronym/term index (human entry point)
• references/ooad-vocabulary.md — single source for leading words (human index: docs/glossary.md)
• README.md