Conversation
Drive brick #4 of the T7/B.7 (ai-native-rag) chain through the Forge planning pipeline (Proposal -> Specs -> Design -> Tasks), STOPPING before implementation. Spec-only; no production code, no persona file, no PR. Mirrors the k3-demeter precedent layout (persona + Janus delta + harness + CLAUDE.md row) but diverges per ADR-K2-003: Pythia is an advisory/tuning specialist (Panoptes mould), NOT a scanner agent -- no bin/forge-*.sh, no data file, no new standard (it consumes the existing b7-standards). Surfaces a BLOCKING name collision (Q-001): the roadmap K.2 agent and the already-shipped Product Analyst both want "Pythia". Logged per Article III.4 with recommended Option B (name K.2 agent "Delphi", keep Product-Analyst- Pythia); maintainer ratification of ADR-K2-001 required before implement. Counts: 31 FR / 7 NFR / 5 ADR / 6 K2-RULE seed / 3 BDD / 3 open questions. Planned deliverables: .claude/agents/<name>.md persona, additive index.yml triggers, Janus Dispatch-Table row + Step 3 note, CLAUDE.md row, harness b7-pythia.test.sh (18 L1 + 1 L2) in forge-ci.yml. Disjoint shared-file collision with sibling b7-9-janus-ai (different Janus sections). .forge.yaml validates against change.schema.json (exit 0); status: planned. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PPnqp5voa9PfC5JJ6HCKQz
…ified) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PPnqp5voa9PfC5JJ6HCKQz
…ner) Add the K.2 AI/RAG specialist agent **Sibyl** for the `ai-native-rag` archetype (roadmap §9 K.2 / §6.2 B.7.4), following the b7-pythia plan via strict TDD (RED 19/19 → GREEN 19/19). Q-001 (persona name collision with the shipped Product-Analyst-Pythia) was ratified by the maintainer to Option B → name **Sibyl** (ADR-K2-001). The existing `.claude/agents/product-analyst.md` (Pythia) and its 4 references are untouched; Sibyl is a brand-new separate agent. Deliverables: - `.claude/agents/sibyl.md` — advisory persona: 4 checklists (Embeddings & Retrieval, pgvector HNSW Tuning, MCP Server Hardening, Prompt Audit & Fallback) operationalising the three B.7.3 b7-standards verbatim, a RAG Readiness Report template, and a 6-rule catalogue (K2-RULE-001..006) whose only Blocking rule is the Article XI.5 mandatory-fallback gate (K2-RULE-006). NO scanner, NO data file, NO new standard (ADR-K2-003). - `.forge/scripts/tests/b7-pythia.test.sh` — 18 L1 + 1 L2 harness; registered in forge-ci.yml after b7-2. ≤ 0.1s wall-clock. - `cross-layer-orchestrator.md` — Janus Step 3 dispatch (Dispatch Table row + Step 3 note + Quality Gates bullet + Constitution-compliance bullet), all disjoint from the J8-RULE Forbidden-archetypes catalogue and Step 9 (collision boundary with b7-9-janus-ai respected; k3 _test_k3_018 GREEN). - `index.yml` — additive `sibyl` trigger on rag-patterns/llm-gateway/mcp-servers + ef-search/embeddings-tuning on rag-patterns (no new entry, ADR-K2-005). - `CLAUDE.md` + `forge-master.md` — AI/RAG-Specialist roster rows. - open-questions.md — Q-002/Q-003 answered (ADR-K2-002/003); design ADR-K2-001 records the ratified name; change flipped to status: implemented. Gates: b7-pythia 19/19, verify.sh PASS (449/0), constitution-linter OVERALL PASS, validate-standards-yaml 0, j7/j8/k3/b7-1/b7-2a/b7-3/b7-2 no regression. [Story: FR-K2-PYT-001..125 / NFR-K2-PYT-001..007 / ADR-K2-001..005] Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PPnqp5voa9PfC5JJ6HCKQz
…native-rag.md (B.7.4) Appends the K.2 ADDED requirements (FR-K2-PYT-* / NFR-K2-PYT-* / ADR-K2-*) to the B.7 consolidated spec (prior b7-1/b7-2a/b7-standards/b7-2 blocks preserved); flips .forge.yaml status -> archived (timeline.archived 2026-06-22, archived_to set). All archive gates GREEN. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PPnqp5voa9PfC5JJ6HCKQz
# Conflicts: # .forge/specs/ai-native-rag.md # CHANGELOG.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
K.2 / B.7.4 — Sibyl, the AI/RAG specialist agent (b7-pythia)
Adds Sibyl, an advisory AI/RAG specialist agent for the
ai-native-ragarchetype — embeddings/retrieval tuning, pgvector HNSWef_search, MCP server hardening, and prompt-audit + mandatory-fallback review. Brick #4 of the B.7 chain.Naming (Q-001)
The roadmap called the K.2 agent "Pythia", but that name is already the shipped Product Analyst (
product-analyst.md). Maintainer ratified Sibyl for the new agent (ADR-K2-001, "Option B"); the existing Product-Analyst-Pythia and its references are untouched.What's in it
.claude/agents/sibyl.md(318 l.): Persona / Purpose / 4 Checklists /RAG Readiness Reportoutput /K2-RULE-001..006catalogue (006 = Blocking, the Article XI.5 mandatory-fallback gate) / Anti-Hallucination Protocol.bin/forge-*.sh, NO data file, NO new standard — guarded by negative tests.cross-layer-orchestrator.md, +5 l.): Dispatch Table row + Step 3 design-pass paragraph + Quality-Gates bullet + Article XI compliance bullet — all in sections disjoint fromb7-9-janus-ai(Step 9 / Demeter + the Forbidden-archetypes catalogue are byte-untouched).index.ymltriggers (rag-patterns / llm-gateway / mcp-servers +ef-search/embeddings-tuning),CLAUDE.md+forge-master.mdroster rows, harnessb7-pythia.test.sh(18 L1 + 1 L2, in CI), CHANGELOG.Verification (all GREEN)
b7-pythia.test.sh19/19 ·verify.shPASS ·constitution-linterPASS ·validate-standards-yaml8/0 · regressionk3 22/0(incl. the Demeter Step-9 + namespace guards) ·j7 21/0 · j8 20/0 · b7-1 19/0 · b7-2a 4/0 · b7-2 7/0 · b7-3 7/0. TDD RED (19/19 fail) → GREEN per the change'stasks.md.Spec consolidated into
.forge/specs/ai-native-rag.md(appended K.2 block; prior B.7 blocks preserved); change archived (status: archived, 2026-06-22). The archetype's promotion toscaffoldable: trueremains gated onb7-6-harness.🤖 Generated with Claude Code
https://claude.ai/code/session_01PPnqp5voa9PfC5JJ6HCKQz