initial: pi-setup workspace with skill + extension plan

2026-06-10 17:30:43 +08:00
commit 49e581247b
158 changed files with 28777 additions and 0 deletions
@@ -0,0 +1,50 @@
+# Domain Evolution Bootstrap
+
+Use this reference when `/evolve` is asked to reshape AgentOps skills, CLI,
+hooks, docs, tests, beads, or knowledge as one software-factory system.
+
+## Product Frame
+
+AgentOps is the SDLC control plane and context compiler for LLM agents. The
+narrow waist is:
+
+- BDD/Gherkin for observable intent;
+- DDD for shared names and bounded contexts;
+- Hexagonal architecture for ports and adapters;
+- TDD for local proof of done;
+- XP for small vertical slices;
+- CI, SRE, ADRs, and provenance for repeated trust and memory.
+
+Do not treat a skill, hook, or command as valuable by itself. It is valuable
+only when it advances the factory loop: intent, boundary, proof, evidence, and
+compounding context.
+
+## Bootstrap Sequence
+
+1. Read current direction from `PRODUCT.md`, `GOALS.md`,
+   `docs/cdlc.md`, and `docs/architecture/operating-loop.md`.
+2. Validate the durable control artifacts:
+
+   ```bash
+   bash scripts/check-agentops-domain-evolution-plan.sh
+   ```
+
+3. Select one domain and one vertical slice from:
+   - `docs/reference/agentops-domain-evolution-bdd.md`
+   - `docs/reference/agentops-skill-domain-map.md`
+   - `docs/reference/agentops-hexagonal-architecture-map.md`
+   - `docs/reference/agentops-domain-evolution-plan.md`
+4. Use `skill-builder` and `skill-auditor` for skill changes. Use
+   `skills/skill-auditor/scripts/score_agentops_skill.py` to choose the
+   smallest score-improving patch.
+5. Keep CLI and hook changes behind typed ports or existing validation scripts.
+6. Run focused validation before selecting the next slice.
+
+## Hard Rules
+
+- No broad rewrite before a Gherkin row, domain, and first proof are named.
+- No third-party content copying; use clean-room structural observations only.
+- No shipped skill deletion until replacement workflow and validation evidence
+  exist.
+- No shell-only read path when a typed port already exists.
+- No unattended run from a dirty canonical root or stale installed `ao` binary.