Scaffold The Family Codex: design, structure, style guide, outline

Set up the family religious book project — six-part modular codex
(Doctrine, Family Canon, Testimony, Practice, Battle Manual, Reference)
with a teaching Reading Path, mixed-voice style guide, master outline,
glossary, and working context for resuming sessions.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude
2026-05-31 21:46:58 -05:00
commit 3dc763ac25
17 changed files with 380 additions and 0 deletions

View File

72
.claude/security/log.txt Normal file
View File

@@ -0,0 +1,72 @@
[2026-05-31 21:29:39.257] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:29:39.259] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:30:08.458] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:30:08.460] Processing: hook_event=Stop, tool=
[2026-05-31 21:30:08.463] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:30:08.464] Stop hook: empty review set
[2026-05-31 21:32:04.827] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:32:04.829] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:32:17.777] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:32:17.779] Processing: hook_event=Stop, tool=
[2026-05-31 21:32:17.782] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:32:17.782] Stop hook: empty review set
[2026-05-31 21:35:17.059] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:35:17.061] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:35:28.782] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:35:28.785] Processing: hook_event=Stop, tool=
[2026-05-31 21:35:28.788] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:35:28.788] Stop hook: empty review set
[2026-05-31 21:36:31.947] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:36:31.949] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:36:44.047] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:36:44.050] Processing: hook_event=Stop, tool=
[2026-05-31 21:36:44.060] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:36:44.061] Stop hook: empty review set
[2026-05-31 21:38:04.955] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:38:04.957] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:38:17.943] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:38:17.945] Processing: hook_event=Stop, tool=
[2026-05-31 21:38:17.948] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:38:17.948] Stop hook: empty review set
[2026-05-31 21:38:46.932] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:38:46.934] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:39:07.446] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:39:07.449] Processing: hook_event=Stop, tool=
[2026-05-31 21:39:07.452] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:39:07.452] Stop hook: empty review set
[2026-05-31 21:40:40.723] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:40:40.726] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:40:59.697] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:40:59.699] Processing: hook_event=Stop, tool=
[2026-05-31 21:40:59.702] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:40:59.703] Stop hook: empty review set
[2026-05-31 21:43:48.784] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:43:48.786] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:44:03.827] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:44:03.829] Processing: hook_event=Stop, tool=
[2026-05-31 21:44:03.832] _git_status_porcelain error: [Errno 138] emscripten does not support processes.
[2026-05-31 21:44:03.833] Stop hook: empty review set
[2026-05-31 21:44:59.016] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:44:59.018] Processing: hook_event=UserPromptSubmit, tool=
[2026-05-31 21:45:14.979] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:14.981] Processing: hook_event=PostToolUse, tool=Bash
[2026-05-31 21:45:15.029] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:15.031] Processing: hook_event=PostToolUse, tool=Bash
[2026-05-31 21:45:15.040] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:15.042] Processing: hook_event=PostToolUse, tool=Bash
[2026-05-31 21:45:15.055] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:15.057] Processing: hook_event=PostToolUse, tool=Bash
[2026-05-31 21:45:15.080] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:15.082] Processing: hook_event=PostToolUse, tool=Bash
[2026-05-31 21:45:38.613] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:38.616] Processing: hook_event=PostToolUse, tool=Write
[2026-05-31 21:45:58.786] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:45:58.789] Processing: hook_event=PostToolUse, tool=Write
[2026-05-31 21:46:14.654] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:46:14.656] Processing: hook_event=PostToolUse, tool=Write
[2026-05-31 21:46:23.219] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:46:23.221] Processing: hook_event=PostToolUse, tool=Write
[2026-05-31 21:46:39.318] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:46:39.320] Processing: hook_event=PostToolUse, tool=Write
[2026-05-31 21:46:49.787] Hook called with args: ['/home/ptarrant/.claude/plugins/cache/claude-plugins-official/security-guidance/2.0.0/hooks/security_reminder_hook.py']
[2026-05-31 21:46:49.789] Processing: hook_event=PostToolUse, tool=Write

View File

@@ -0,0 +1 @@
{"shown_warnings": [], "touched_paths": ["/home/ptarrant/repos/ptarrant/demonologoy/docs/2026-05-31-family-codex-design.md", "/home/ptarrant/repos/ptarrant/demonologoy/docs/STYLE-GUIDE.md", "/home/ptarrant/repos/ptarrant/demonologoy/docs/OUTLINE.md", "/home/ptarrant/repos/ptarrant/demonologoy/docs/GLOSSARY-MASTER.md", "/home/ptarrant/repos/ptarrant/demonologoy/CLAUDE.md", "/home/ptarrant/repos/ptarrant/demonologoy/README.md"]}

7
.gitignore vendored Normal file
View File

@@ -0,0 +1,7 @@
# OS / editor cruft
.DS_Store
Thumbs.db
*.swp
*~
.idea/
.vscode/

44
CLAUDE.md Normal file
View File

@@ -0,0 +1,44 @@
# CLAUDE.md — Working Context
Read this first when resuming. This is a **family religious book** project.
## What this is
An authoritative family text: a modern teaching tool for the family's personal theology (Gnostic/Sethian + New Testament tie-ins, built from the author's lived demonic experience and research), plus a tactical spiritual-battle manual. For the author's wife and daughter now (reference), and future generations later (teaching).
Full blueprint: **`docs/2026-05-31-family-codex-design.md`** — read it before working.
## The most important rule
**Never invent doctrine, entities, rituals, or events.** The author is the sole authority on belief and experience. If material is missing, ask or write `[NEEDS YOUR INPUT]`. Claude's job: organize, shape, phrase, structure, cross-link — never originate substance.
## Structure
- 6 Parts, each a self-contained cross-linked module ("Codex with a Path"):
- I Doctrine · II Family Canon · III Testimony · IV Practice & Devotion · V Battle Manual · VI Reference
- Front matter holds the **Reading Path** (teaching sequence).
- Mixed voice by Part — see `docs/STYLE-GUIDE.md`.
## Files
- `docs/2026-05-31-family-codex-design.md` — master design
- `docs/OUTLINE.md` — chapter list + Reading Path (living)
- `docs/STYLE-GUIDE.md` — voices, capitalization, ritual/testimony formats, citations
- `docs/GLOSSARY-MASTER.md` — every term + its canonical home
- `input/` — author's raw material
- `book/partN-*/` — finished chapters (`chNN-short-title.md`)
## Drafting loop
1. Author supplies raw material (in `input/` or spoken).
2. Claude drafts chapter in correct Part folder + voice.
3. Author reviews/corrects.
4. Claude revises, locks chapter, updates glossary + cross-links, commits.
## Tone in this project
Treat the subject with full respect. This is sacred to the family. Be precise, careful, and reverent. Caveman/brief mode may be active for chat, but **book prose is always written in full, polished form** per the style guide.
## Where we are
See the Status section at the bottom of the design doc and the `[NEEDS YOUR INPUT]` markers across `docs/`.

29
README.md Normal file
View File

@@ -0,0 +1,29 @@
# The Family Codex
A family religious text — written to be a reference today and a teaching tool for generations to come.
It gathers a personal theology (Gnostic / Sethian teachings with New Testament tie-ins), the record of lived spiritual experience, the family's own canon, daily practice, and a step-by-step manual for spiritual battle.
## Contents
| Part | Subject |
|------|---------|
| I | **Doctrine** — what we believe |
| II | **Family Canon** — who we are, why this book exists |
| III | **Testimony** — the record of real encounters |
| IV | **Practice & Devotion** — how we live the faith |
| V | **The Spiritual Battle Manual** — how we protect and fight |
| VI | **Reference** — glossary, names, lookup tables |
## Repository
- `book/` — the finished chapters, by Part.
- `docs/` — design, outline, style guide, glossary.
- `input/` — raw material being shaped into chapters.
- `CLAUDE.md` — working context for resuming sessions.
Start with `docs/2026-05-31-family-codex-design.md` for the full plan.
## Status
In progress. Structure and plan complete; chapters underway.

View File

View File

View File

View File

View File

View File

View File

@@ -0,0 +1,102 @@
# The Family Codex — Design Document
*Created 2026-05-31. This is the master blueprint for the book. Read this first when resuming work.*
---
## 1. Purpose
A family religious text. Two jobs:
1. **Reference now** — for the author's wife and daughter, who already share the faith. Look things up: a ritual, an entity, a point of doctrine.
2. **Teaching tool later** — to pass the faith to the daughter's children and future generations, taught in sequence from the ground up.
Authoritative for the family. Not a Bible — a modern learning tool for the family religion, plus a tactical guide to spiritual battle. Possibly published (Amazon KDP) later, but family use is primary.
## 2. The Faith (scope)
Personal theology built from lived experience and research:
- **Gnostic / Sethian** teachings at the core (cosmology, the divine).
- **New Testament** tie-ins woven through.
- **Lived demonic experience** as testimony and evidence.
- A **tactical spiritual-battle** discipline — plans, protection, rituals, discernment.
## 3. Audience
Family. Wife and daughter already know the faith (reference altitude). Future generations do not (teaching altitude). The book must serve both — hence reference-first modules **plus** a defined teaching sequence (the Reading Path).
## 4. Architecture — "Codex with a Path"
Each Part is a **self-contained, cross-linked module**. Reference-first: jump straight to any entity, ritual, or doctrine. A **Reading Path** in the front matter defines the order to teach a newcomer.
Modular by design so it can split into two volumes later (*Book of Belief* + *Book of War*) with no rework.
### The Six Parts
| Part | Title | Voice |
|------|-------|-------|
| I | **Doctrine** — cosmology, the divine, Sethian/Gnostic core, NT tie-ins | Elevated / scriptural |
| II | **Family Canon** — origin of our faith, lineage, why this book exists | Warm + reverent |
| III | **Testimony** — the author's demonic encounters, as record + lesson | Plain, first-person |
| IV | **Practice & Devotion** — daily/weekly rites, prayers, calendar | Warm teaching |
| V | **The Spiritual Battle Manual** — discernment, protection, battle plans, rituals, step-by-step | Field manual |
| VI | **Reference** — glossary, entities/names, quick-lookup tables | Terse reference |
**Default ordering logic:** foundation (Doctrine) → who we are (Canon) → why it's real (Testimony) → how we live it (Practice) → how we fight (Battle) → lookup (Reference).
**Reading Path (teaching a child)** may reorder, e.g. Canon → Doctrine → Practice → Battle → Testimony → Reference. Finalized in `OUTLINE.md`.
### Front Matter
- Dedication / letter to the reader (author → daughter → descendants).
- The Reading Path (numbered teaching order).
- How to use this book (reference vs. cover-to-cover).
### Cross-Linking
Every entity / term / ritual has a **canonical home** in one Part. Other Parts link to it via markdown links. The Battle Manual cites Doctrine; the Glossary points back to full treatments. `GLOSSARY-MASTER.md` tracks every term and its canonical location.
## 5. Voice
Mixed by section (see table above and `STYLE-GUIDE.md`). Four registers: scriptural, warm-teaching, plain-testimony, field-manual.
## 6. Production System
### Folder layout
```
input/ raw dumps — notes, memory transcripts, research links (messy OK, one file per topic)
docs/ this design doc, STYLE-GUIDE.md, OUTLINE.md, GLOSSARY-MASTER.md
book/ finished chapters, numbered markdown
part1-doctrine/ part2-canon/ part3-testimony/
part4-practice/ part5-battle/ part6-reference/
CLAUDE.md working context for resuming sessions
README.md project overview
```
### Drafting loop (per chapter)
1. Author drops raw material in `input/` (or speaks it; Claude captures).
2. Claude drafts the chapter in its Part folder, in that section's voice.
3. Author reviews — corrects theology, facts, tone. **The author is the authority.**
4. Claude revises, locks the chapter, updates `GLOSSARY-MASTER.md` + cross-links.
5. Repeat.
### Hard rule — no invention
Claude **never invents** doctrine, entities, rituals, or events. Missing material → ask, or mark `[NEEDS YOUR INPUT]`. The author's lived experience and beliefs are the only source of truth. Claude shapes, organizes, phrases, and structures; the author supplies all substance.
### Version control
Git tracks every change. Nothing is lost. Commit per locked chapter (or more often).
## 7. Status / Next Steps
- [x] Design approved
- [x] Repo + folder structure created
- [ ] `STYLE-GUIDE.md` drafted
- [ ] `OUTLINE.md` drafted (full chapter list + Reading Path)
- [ ] First Part begun
Recommended first draft target: **Part II — Family Canon** (origin + dedication) or **Part I — Doctrine**. Decide at next session.

9
docs/GLOSSARY-MASTER.md Normal file
View File

@@ -0,0 +1,9 @@
# Master Glossary
*Running list of every term, name, and entity. Each has ONE canonical home chapter; everything else links to it. This feeds Part VI. Add rows as drafting proceeds.*
| Term | Type | Canonical home | One-line definition |
|------|------|----------------|---------------------|
| *(example)* Sophia | Aeon | part1-doctrine/ch03 | The Aeon whose fall produces the material world. |
`[Author + Claude fill this in as chapters are drafted. Keep spellings fixed here.]`

57
docs/OUTLINE.md Normal file
View File

@@ -0,0 +1,57 @@
# Master Outline & Reading Path
*The living chapter list. Chapters get added/refined as material comes in. `[NEEDS YOUR INPUT]` = author to supply.*
## Reading Path (teaching order, for a newcomer)
Proposed sequence for teaching a child/descendant from zero. Reorder freely.
1. Front matter — letter to the reader.
2. Part II — Family Canon (who we are, why this exists).
3. Part I — Doctrine (what we believe).
4. Part IV — Practice & Devotion (how we live it).
5. Part V — Battle Manual (how we protect + fight).
6. Part III — Testimony (why it's real — read once mature).
7. Part VI — Reference (lifelong lookup).
`[NEEDS YOUR INPUT: confirm or adjust this order]`
---
## Part I — Doctrine *(scriptural voice)*
- ch01 — `[NEEDS YOUR INPUT]` (e.g. The Divine / the True God)
- ch02 — Cosmology: the Pleroma, the Aeons
- ch03 — Sophia and the fall
- ch04 — The Demiurge and the material world
- ch05 — The human condition (spirit, soul, the divine spark)
- ch06 — New Testament tie-ins
- (more TBD from material)
## Part II — Family Canon *(warm + reverent)*
- ch01 — Dedication / letter to the reader
- ch02 — Origin of our faith in this family
- ch03 — Lineage & why this book exists
- (more TBD)
## Part III — Testimony *(plain, first-person)*
- ch01 — `[NEEDS YOUR INPUT: first encounter]`
- (one chapter per account)
## Part IV — Practice & Devotion *(warm teaching)*
- ch01 — Daily practice
- ch02 — Weekly / seasonal observances
- ch03 — Prayers & rites
- ch04 — The calendar `[NEEDS YOUR INPUT: dates/feasts]`
## Part V — The Spiritual Battle Manual *(field manual)*
- ch01 — Discernment: recognizing the enemy
- ch02 — Protection & wards (baseline defense)
- ch03 — Battle plans (step-by-step engagement)
- ch04 — Rituals of cleansing / banishing
- ch05 — Aftercare & recovery
- (more TBD)
## Part VI — Reference *(terse)*
- Glossary (from GLOSSARY-MASTER.md)
- Entities & names index
- Quick-lookup tables (wards, signs, correspondences)

59
docs/STYLE-GUIDE.md Normal file
View File

@@ -0,0 +1,59 @@
# Style Guide
*Conventions for the whole book. Update as decisions are made. `[NEEDS YOUR INPUT]` marks things only the author can settle.*
## The Four Voices
| Voice | Used in | Feel |
|-------|---------|------|
| **Scriptural** | Part I Doctrine | Elevated, reverent, timeless. Meant to be quoted. Short, weighty sentences. |
| **Warm-teaching** | Part II Canon, Part IV Practice | Direct address, patient, explains as it goes. Author guiding family. |
| **Plain-testimony** | Part III Testimony | First-person, honest, unadorned. Record of real events. |
| **Field-manual** | Part V Battle | Precise, numbered, imperative. Materials, steps, warnings. No ornament. |
## Capitalization
- Divine names / the highest powers: **Capitalized**. `[NEEDS YOUR INPUT: list canonical Divine names + spellings]`
- Sethian/Gnostic figures (e.g. Sophia, the Aeons, the Demiurge): Capitalized, spelling fixed in `GLOSSARY-MASTER.md`.
- Hostile entities / demons: `[NEEDS YOUR INPUT: capitalize? name conventions?]`
- "the faith," "the family" — lowercase unless titling.
## Ritual Format (Part V)
Every ritual uses this template:
```
### [Ritual Name]
**Purpose:** one line.
**When to use:** trigger conditions.
**Materials:** bulleted list.
**Warnings:** dangers, prohibitions, who must not perform it.
**Steps:**
1. ...
2. ...
**Closing / aftercare:** how to end safely.
**See also:** [links to related doctrine/entities]
```
## Testimony Format (Part III)
- First person, past tense.
- Optional header block: *When / Where / Who was present.*
- End each account with a **Lesson** — what it teaches for the faith or for battle.
## Scripture / Source Citation
- New Testament: `Book Chapter:Verse` (e.g. John 1:1). Translation: `[NEEDS YOUR INPUT: which translation?]`
- Gnostic/Sethian sources (e.g. Apocryphon of John, Gospel of Thomas): *Title*, section. `[NEEDS YOUR INPUT: preferred editions/translations]`
- Family canon (oral, experiential): cite as *Family Canon* or the relevant Testimony chapter.
## Cross-References
- Link to a term's canonical home: `[Sophia](../part1-doctrine/ch-cosmology.md#sophia)`.
- First mention of any glossary term in a chapter links to its canonical home.
## Formatting
- Markdown. One chapter per file. Filename: `chNN-short-title.md`.
- Chapter top: `# Part N · Chapter NN — Title`.
- Avoid heavy nesting; prefer clear headers.

0
input/.gitkeep Normal file
View File