Document Control Registry
Purpose: Tracks the classification and lifecycle status of all documentation across the ChurchWiseAI portfolio. Agents consult this to know which docs to trust.
Last audited: 2026-03-25
Trust Hierarchy (CLAUDE.md Rule 15)
C:\dev\knowledge\(canonical) — ALWAYS trust- Per-codebase CLAUDE.md — trust for code-level context
C:\dev\knowledge\drafts\— read but verify (proposals, not facts)- Any other .md file — check knowledge/ first
C:\dev\knowledge\archive\— do NOT use for current decisions
Three Zones
| Zone | Location | Status |
|---|---|---|
| Canonical | C:\dev\knowledge\ | Source of truth. Verified, current, trusted. |
| Working | C:\dev\knowledge\drafts\ | In-progress. Not yet approved. |
| Archive | C:\dev\knowledge\archive\ | Superseded. Read-only historical reference. |
Archived Documents (2026-03-25)
| Original Location | Reason | Superseded By |
|---|---|---|
C:\dev\PIVOT_PLAN.md | Outdated pivot plan, wrong prices, references Railway | knowledge/narrative/strategy.md |
C:\dev\PLATFORM_STRATEGY.md | References 4 voice agents (now 2), Phase 1 complete | knowledge/narrative/strategy.md |
C:\dev\GEMINI.md | References Railway/ElevenLabs, stale pricing, wrong church counts | C:\dev\CLAUDE.md |
churchwiseai-web/docs/internal/OPERATIONS_GUIDE.md | References Railway infrastructure | knowledge/architecture/system-overview.md (pending) |
churchwiseai-web/docs/DEPLOYMENT_RUNBOOK.md | Lists Railway service URLs | knowledge/runbooks/deployment/ (pending) |
churchwiseai-web/docs/GO_LIVE_CHECKLIST.md | References Railway services | knowledge/runbooks/ (pending) |
churchwiseai-web/docs/GO_LIVE_ORDER.md | Tactical details outdated (Feb 2026) | knowledge/narrative/strategy.md |
churchwiseai-web/docs/GO_LIVE_AUDIT_PLAN_2026-02-27.md | One month old, references old state | AGENT_QUALITY_PRINCIPLES.md + QA_CHECKLIST.md |
Root-Level Files (C:\dev)
Only these files belong at root:
| File | Status | Purpose |
|---|---|---|
CLAUDE.md | CANONICAL | Agent briefing (will slim after knowledge/ populated) |
DECISION_LOG.md | CANONICAL | Append-only decision journal |
FOUNDER_ACTIONS.md | CANONICAL | Action items for founder |
FEATURE_REGISTRY.md | CANONICAL | Feature ownership map |
AGENT_QUALITY_PRINCIPLES.md | CANONICAL | 35 quality rules from 165 bugs |
QA_CHECKLIST.md | CANONICAL | Pre-completion QA checklist |
PRICING.md | CANONICAL | Stripe source of truth (derived from knowledge/data/pricing.yaml) |
INSTITUTIONAL_KNOWLEDGE.md | CANONICAL | Compiled narrative briefing |
REMOTION_STRATEGY.md | CANONICAL | Video generation reference |
TEST_URLS.md | CANONICAL | Admin URLs and test configs |
GO_LIVE_CHECKLIST.md | CANONICAL | Launch readiness (root copy) |
AGENT_BRIEFING_KNOWLEDGE_SYSTEM.md | WORKING | Active project context |
TESTING_PROMPT_CROSS_SOURCE_CONSISTENCY.md | WORKING | Testing guidance for knowledge system |
VOICE_HOSTING_STRATEGY.md | WORKING | Live architecture decision (Cartesia fallback) |
VOICE_ROUTING_HANDOFF.md | WORKING | In-progress bug fix |
Per-Codebase Docs
churchwiseai-web/
| File | Status | Notes |
|---|---|---|
CLAUDE.md | CANONICAL | Project-specific agent briefing |
CHATBOT_UX_ARCHITECTURE.md | CANONICAL | Absorb to knowledge/products/chatbot/ux-model.md in Phase 2 |
DESIGN_PRINCIPLES.md | CANONICAL | Keep until design skill supersedes |
AGENTIC_TOOLS_CATALOG.md | CANONICAL | Absorb to knowledge/data/tools.yaml |
BACKLOG.md | CANONICAL | Product backlog |
docs/PRODUCT_VISION.md | CANONICAL | Foundational strategy |
docs/MASTER_VISION.md | CANONICAL | Founder's playbook |
docs/REVENUE_STRATEGY.md | CANONICAL | Revenue plan |
docs/MARKETING_STRATEGY.md | CANONICAL | GTM philosophy |
docs/WRITING_PRINCIPLES.md | CANONICAL | Blog voice guide |
docs/USE_CASE_CATALOG.md | CANONICAL | Demo pain points |
docs/SERVICE_INVENTORY.md | CANONICAL | Third-party services |
docs/internal/database-tables.md | CANONICAL | Schema reference |
docs/QA_CHECKLIST.md | CANONICAL | 515 QA tests |
docs/PRODUCT_BACKLOG.md | CANONICAL | Feature ideas |
docs/superpowers/specs/*.md | CANONICAL | Approved design specs |
docs/superpowers/plans/*.md | CANONICAL | Implementation plans |
voice-agent-line/DEPLOY.md | CANONICAL | LiveKit voice agent deployment guide |
voice-agent-line/AGENT_AUDIT.md | CANONICAL | Voice agent tool matrix |
VOICE_LINE_MIGRATION_PLAN.md | STALE | Completed migration — archive next pass |
IMPLEMENTATION_PLAN.md | UNKNOWN | Check status — archive if done |
pewsearch/
| File | Status | Notes |
|---|---|---|
CLAUDE.md | CANONICAL | Fixed church count 2026-03-25 |
BACKLOG.md | CANONICAL | Feature backlog |
ENRICHMENT_PLAYBOOK.md | CANONICAL | Directory building guide |
docs/PRO_WEBSITE.md | CANONICAL | 692-line product spec |
docs/ADMIN_DASHBOARD.md | CANONICAL | Admin reference |
docs/API_REFERENCE.md | CANONICAL | API endpoints |
docs/ARCHITECTURE.md | CANONICAL | Fixed church count 2026-03-25 |
docs/ROLE_WORKFLOWS.md | CANONICAL | RBAC matrix |
data_quality_report.md | STALE | 1 month old — archive next pass |
PRO_WEBSITE_PLAN.md | STALE | Stub pointing to old plan file |
web/API_TEST_MATRIX.md | STALE | 8 days old, no follow-up |
web/E2E_TEST_PLAN.md | STALE | 1 month old |
web/TRAINING_TAB_PLAN.md | ABSORB | Move to docs/ with status header |
sermon-illustrations/
| File | Status | Notes |
|---|---|---|
CLAUDE.md | CANONICAL | Accurate |
BACKLOG.md | CANONICAL | Feature backlog |
internal/shared-database-contract.md | CANONICAL | Critical cross-project safety |
internal/content-pipeline.md | CANONICAL | Illustration flow |
internal/content-rules.md | CANONICAL | Theological content rules |
internal/image-style-research.md | CANONICAL | Image generation guidance |
internal/README.md | CANONICAL | Index for internal docs |
internal/scripts.md | STALE | Incomplete — only 1 of ~5 scripts documented |
README.md | STALE | Generic Next.js boilerplate |
GEMINI.md | STALE | Points to non-existent file |
E2E_TEST_PLAN.md | STALE | 1 month old |
Future Cleanup (Phase 1-6 Absorption)
As knowledge/ docs are written in later phases, these codebase docs will be absorbed:
| Codebase Doc | Will Be Absorbed Into | Phase |
|---|---|---|
CHATBOT_UX_ARCHITECTURE.md | knowledge/products/chatbot/ux-model.md | 2 |
AGENTIC_TOOLS_CATALOG.md | knowledge/data/tools.yaml (already exists) | 2 |
docs/PRODUCT_VISION.md | knowledge/narrative/vision.md (enrich) | 1 |
docs/SERVICE_INVENTORY.md | knowledge/integrations/*.md | 5 |
docs/internal/database-tables.md | knowledge/architecture/database-schema.md | 1 |
ENRICHMENT_PLAYBOOK.md | knowledge/runbooks/content-ops/data-enrichment.md | 6 |
Draft → Canonical Promotion Checklist
A knowledge/drafts/ file becomes canonical when it passes ALL of the following gates. Run this checklist before moving a file from drafts/ to its target location.
Gate 1: Content verification
- Every factual claim verified against current code (check
code-files:frontmatter) - Every DB table reference checked against actual Supabase schema
- Every price/dollar figure matches
knowledge/data/pricing.yaml - Every code path confirmed to still exist (grep or file-check)
- No "TBD", "TODO", or placeholder text remains
- No actual secrets — only env var NAMES, never values
Gate 2: Frontmatter completeness
-
title:— clear, descriptive document title -
description:— one-line summary (used in INDEX.md) -
parent:— path to parent doc or README -
tags:— at least 2 relevant tags -
last-verified:— today's date in YYYY-MM-DD format -
code-files:— all referenced source files listed (or empty list if none) -
db-tables:— all referenced tables listed (or empty list if none)
Gate 3: Navigation
- Breadcrumb at top:
[Knowledge](../INDEX.md) > [Category](README.md) > **This Doc** - "See Also" section at bottom with parent, related, and runbook links
- Parent doc updated: add this file to its
children:list
Gate 4: Automation verification
- Run
pnpm test— all 10 test files pass - Run
pnpm derive knowledge:docs— no broken links reported - Run
pnpm derive --check— no drift detected
Gate 5: Review
- Reviewed as "senior QA engineer" — edge cases, error paths, accuracy
- If doc references any feature: manually tested or verified it works
- Description field useful enough for INDEX.md navigation (not "a doc about X")
After promotion
- Move file from
drafts/to canonical location - Update
DOCUMENT_CONTROL.mdwith new entry - Run
pnpm derive knowledge:docsto regenerate INDEX.md - Add 1-line entry to
DECISION_LOG.md:promoted drafts/X.md to canonical
Plan File Hygiene
Active plans live in ~/.claude/plans/. Naming convention: YYYY-MM-DD-description.md
Cleanup rule: Plans older than 60 days with no active reference in any knowledge/ doc or CLAUDE.md should be deleted. When completing a project:
- Archive any working drafts in
knowledge/drafts/that are no longer active - Move handoff docs to
knowledge/drafts/if they have ongoing value - Remove stale implementation plans from
~/.claude/plans/