| name | pith-wiki |
| description | Wiki mode — persistent knowledge base maintenance. Active during /pith wiki mode. Defines page formats, ingest workflow, query workflow, and lint checks.
|
Wiki mode behavior
When wiki mode is active:
- After significant decisions: offer to save to wiki
- After bugs solved: offer to save resolution
- After architecture discussions: offer to save as decision record
- After ingest: show what was updated, ask for confirmation
- Keep all offers brief: one line. User says yes/no.
Page formats
Entity page (person, company, tool, service, component)
# [Entity Name]
**Type:** person | org | tool | service | component
**Summary:** [2 sentences max]
## Key Facts
- [fact]
- [fact]
## Connections
- [[related-entity]] — [how they relate]
## Sources
- [source title](../raw/sources/file.md) — [date]
## Contradictions
- [claim in source A] vs [claim in source B] — unresolved
Concept page (idea, pattern, method, principle)
# [Concept Name]
**Definition:** [one sentence]
**Why it matters:** [one sentence]
## How it works
[2-4 sentences max]
## Related
- [[concept]] — [relation]
## Examples
- [concrete example]
## Open questions
- [what's still unclear]
## Sources
- [source](../raw/sources/file.md)
Decision record
# Decision: [what was decided]
**Date:** YYYY-MM-DD
**Status:** decided | revisiting | superseded
## Context
[1-2 sentences: why this decision was needed]
## Options considered
| Option | Pro | Con |
|--------|-----|-----|
| A | ... | ... |
## Decision
[what was chosen and single-sentence why]
## Consequences
- [what this enables]
- [what this constrains]
Synthesis / analysis page
# [Title]
**Thesis:** [one-sentence claim]
**Confidence:** high | medium | low
## Evidence
- [point] — [source](../raw/sources/file.md)
## Counter-evidence
- [point that argues against the thesis]
## Open questions
- [what would change this conclusion]
index.md format
One entry per wiki page. Updated on every ingest or new page.
# Wiki Index
## Entities
- [[EntityName]] — [one-line description] — [source count] sources
## Concepts
- [[ConceptName]] — [one-line description]
## Decisions
- [[Decision-title]] — [date] — [status]
## Syntheses
- [[Synthesis-title]] — [one-line thesis]
## Sources processed
- [Source Title](raw/sources/file.md) — [date ingested] — [pages updated]
log.md format
Append-only. One entry per operation.
## [YYYY-MM-DD] ingest | [Source Title]
Pages updated: [[page1]], [[page2]], [[page3]]
New pages: [[new-page]]
Contradictions found: [yes/no — detail if yes]
## [YYYY-MM-DD] query | [question summary]
Pages consulted: [[page1]], [[page2]]
Answer filed: [[synthesis-page]] (yes/no)
## [YYYY-MM-DD] lint
Issues found: [N orphan pages, M stale claims, K missing cross-refs]
Ingest workflow
When /pith ingest <file> is called:
- Run
python3 tools/ingest.py <file>
When /pith ingest --url <url> is called:
- Run
python3 tools/ingest.py --url <url>
- Fetches URL, strips HTML, saves to
raw/sources/YYYY-MM-DD-slug.md
- Then runs same ingest pipeline as a local file
Compile workflow
When /pith compile is called:
- Run
python3 tools/compile.py
- Reads all files in
raw/sources/
- Asks Claude to identify cross-source topics and synthesis opportunities
- Creates/updates
wiki/concepts/ pages with multi-source evidence
- Files gaps back to wiki log
When /pith compile --topic <topic> is called:
- Run
python3 tools/compile.py --topic "<topic>"
When /pith compile --dry-run is called:
- Run
python3 tools/compile.py --dry-run
- Shows plan (topics, synthesis pages, gaps) without writing anything
Lint checks
When /pith lint is called:
- Run
python3 tools/lint.py
- Structural: orphan pages, missing sources, broken index links, stale contradictions
- Semantic (LLM): cross-page contradictions, missing entity pages, suggested connections, knowledge gaps, imputable facts
When /pith lint --fix is called:
- Run
python3 tools/lint.py --fix
- Same as above + auto-creates stub pages for missing entities
When /pith lint --quick is called:
- Run
python3 tools/lint.py --quick
- Structural checks only, no LLM call
Query workflow
When /pith wiki "<question>":
- Read index.md — identify relevant page entries
- Load those pages (Pith compresses each read automatically)
- Synthesize answer with citations: "Based on [[page1]] and [[page2]]..."
- Offer to file the answer: "Worth saving this as a synthesis page?"
Boundaries
Never modify files in raw/sources/ — those are immutable source documents.
Always write compressed, cross-linked pages. No verbose prose.
Every new entity or concept gets its own page — no inline-only mentions.
