loopany-core

# loopany-core — artifact operations Read this first when working in a loopany workspace. Routes you to the right kind playbook for any artifact operation. ## Bootstrap ```bash loopany artifact list --kind mission --status active ``` No active mission → run onboarding first (see `ONBOARDING.md`). ## Kind routing Each kind file has schema (Frontmatter, Status machine) AND operational guide (§ Playbook). Read the kind file before creating or modifying. | Trigger | Read | |---------|------| | Committing to work, `[change]` / `[incident]` | `kinds/task.md` | | Writing Outcome, flipping task status | `kinds/task.md § Playbook` | | Noticed something, can't act now | `kinds/signal.md` | | Dismissing / upgrading a signal | `kinds/signal.md § Playbook` | | Writing a learning | `kinds/learning.md` | | Writing a skill-proposal | `kinds/skill-proposal.md` | | Creating / updating a mission | `kinds/mission.md` | | Writing a brief | `kinds/brief.md` | | Recording a person entity | `kinds/person.md` | | Anything else | `kinds/note.md` | | What was created today (read-only) | `kinds/journal.md` | ## Decision rule | State | Artifact | |---|---| | Acting now / committed | `task` | | Deferred / unverified | `signal` | | Pattern-backed belief | `learning` (via `loopany-reflect`) | | Belief implies skill edit | `skill-proposal` (via `loopany-reflect`) | | Long-running pursuit | `mission` | | Point-in-time summary | `brief` | | Human entity | `person` | | Nothing unresolved | nothing, or `note` if rationale matters | | Duplicate | append evidence; don't fork | ## Pass `--slug` for anything you'll cite later The slug IS the id, and it's what shows up in `[[citations]]`. Pass one whenever the artifact has a natural name (`q2-cac-spike`, `alice-chen`). Omit only for batch ingestion — the auto-derived id is fine but ugly. ## Conventions - **Relations** (`conventions/relations.md`) — 6 canonical verbs for `refs add`. - **Taxonomy** (`conventions/taxonomy.md`) — note vs kind vs domain decision tree. ## Related skills | Need | Skill | |------|-------| | First-read routing for any loopany interaction | `loopany-resolver` | | Self-improvement (reflect → learning → proposal) | `loopany-reflect` | | Periodic reviews (daily / weekly / monthly) | `loopany-review` | | Auto-capture after work concludes | `loopany-capture` | ## Anti-patterns - ❌ Acting without reading the kind playbook. - ❌ Skipping anti-patterns sections — failure modes live there. - ❌ Creating an artifact without checking this routing table first.