From c78698a7353be08549b218b3cfa0c7ddfeda1291 Mon Sep 17 00:00:00 2001
From: "Carlos D. Escobar-Valbuena" <carlosdavidescobar@gmail.com>
Date: Sun, 28 Jun 2026 21:15:05 -0500
Subject: [PATCH] feat(roster): add missing primitive-implementation skills +
 fix kg P6 mistag (BRO-1586)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The roster claimed to be the bstack-stack but omitted core primitive
implementations. Careful curation pass (56 → 61 entries, all broomva/skills,
descriptions from each skill's real frontmatter):
- bookkeeping  — knowledge,    primitive P6,  required (universal knowledge engine)
- persist      — orchestration, primitive P12, required (Persistent Loop Discipline)
- dogfood      — lifecycle,     primitive P11, required (Empirical feedback / Dogfood)
- skillify     — meta,          optional       (skill-creation gate + skillify_check)
- checkit      — knowledge,     optional       (ingest-and-integrate; a role-x/P17 lens)

Fix: kg was mis-tagged primitive: P6. P6 is Bookkeeping (bookkeeping's own
frontmatter declares P6; kg's description says it 'pairs with bookkeeping's
cmd_index'). Dropped kg's primitive tag → one canonical P6 = bookkeeping. kg
stays required/knowledge.

Deliberately NOT added (general capability skills, not bstack-native primitives):
agentic-vps, architecture-design-principles, broomva-cli, design-engineering,
colombia-conflict. skills-roster.md not row-mirrored — its banner already makes
companion-skills.yaml authoritative and itself a broader catalog.

Validated: schema · no duplicate primitive tags (P6/P11/P12 each →1) · no dup names
· drift-guard remote resolution (all 61 resolve in broomva/skills) · installer uses
--skill <name> for all 61.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 references/companion-skills.yaml | 39 +++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/references/companion-skills.yaml b/references/companion-skills.yaml
index e927fdf..2a40225 100644
--- a/references/companion-skills.yaml
+++ b/references/companion-skills.yaml
@@ -31,6 +31,14 @@ skills:
     introduced_in: 0.2.0
     description: "Cross-model adversarial review gate"
 
+  - name: dogfood
+    repo: broomva/skills
+    category: lifecycle
+    primitive: P11
+    required: true
+    introduced_in: 0.28.0
+    description: "P11 — Empirical feedback. Triggers the Dogfood Plan + per-stack cookbook + Dogfood Receipt; auto-detects the stack and validates by interacting, not reasoning."
+
   - name: role-x
     repo: broomva/skills
     category: meta
@@ -59,12 +67,19 @@ skills:
   - name: kg
     repo: broomva/skills
     category: knowledge
-    primitive: P6
     required: true
     introduced_in: 0.14.0
     min_bstack_version: 0.14.0
     description: "LLM-as-index loader for research/entities/. Two-tier scoring (catalog tier-1, body-grep tier-2 fallback) routes a topic to top-N entity bodies the agent reasons over. Pairs with bookkeeping's cmd_index (catalog generator) and the workspace's knowledge-catalog-refresh-hook.sh Stop hook (P6)."
 
+  - name: bookkeeping
+    repo: broomva/skills
+    category: knowledge
+    primitive: P6
+    required: true
+    introduced_in: 0.28.0
+    description: "P6 — universal knowledge engine: scores, promotes, and compounds knowledge from all sources into a permanent, query-able entity graph. The catalog generator (cmd_index) behind the knowledge-catalog-refresh Stop hook."
+
   - name: prompt-library
     repo: broomva/skills
     category: meta
@@ -81,6 +96,14 @@ skills:
     introduced_in: 0.1.0
     description: "CI watcher + productive-wait"
 
+  - name: persist
+    repo: broomva/skills
+    category: orchestration
+    primitive: P12
+    required: true
+    introduced_in: 0.28.0
+    description: "P12 — Persistent Loop Discipline. Cross-context restart loop where state lives in the filesystem (PROMPT.md + git tree + state.jsonl); each iteration is a fresh agent context. Backpressure from compilers/tests, not model self-grading."
+
   - name: alkosto-wait-optimizer
     repo: broomva/skills
     skillPath: skills/alkosto-wait-optimizer/SKILL.md
@@ -253,6 +276,13 @@ skills:
     min_bstack_version: 0.21.0
     description: "Multi-source research with citation tracking — 10+ source synthesis (migrated from broomva/deep-dive-research-skill; renamed)"
 
+  - name: checkit
+    repo: broomva/skills
+    category: knowledge
+    required: false
+    introduced_in: 0.28.0
+    description: "Ingest-and-integrate an artifact shared with a terse directive ('check this out', 'lets research this'): contextualize -> research (verify sources) -> connect -> document -> ranked next steps. A role-x (P17) lens."
+
   - name: social-intelligence
     repo: broomva/skills
     skillPath: skills/social-intelligence/SKILL.md
@@ -298,6 +328,13 @@ skills:
     introduced_in: 0.1.0
     description: "Canonical reference of all available skills"
 
+  - name: skillify
+    repo: broomva/skills
+    category: meta
+    required: false
+    introduced_in: 0.28.0
+    description: "Distill a working session into a permanent, TESTED, registered skill. Its deterministic skillify_check gate (10 steps incl. reference-integrity) makes 'a feature that doesn't pass all ten is not a skill' machine-checkable."
+
   # ── Design + frontend ───────────────────────────────────────────────────
   - name: arcan-glass
     repo: broomva/skills