docs: README zieht den Datums-Shard und das flache incoming/ nach (Nachzug zu #67)
CI / verify (push) Successful in 51s

Files changed:
- README.md
This commit is contained in:
2026-09-08 21:43:55 +02:00
parent f4353ccfb3
commit d9af88ffb8
+18 -18
View File
@@ -75,17 +75,14 @@ chemenu/
│ ├── publish-cycle.md │ ├── publish-cycle.md
│ ├── ingest-large-tree.md │ ├── ingest-large-tree.md
│ └── wiki-*/SKILL.md # Skills - copied into .agents/skills/ and .claude/skills/ │ └── wiki-*/SKILL.md # Skills - copied into .agents/skills/ and .claude/skills/
├── incoming/ # INBOX: gitignored - drop a file here, `raw accept` promotes it ├── incoming/ # INBOX: gitignored and flat - drop a file here, `raw accept` promotes it
│ ├── articles/ # Same four type directories as raw/, mirrored ├── raw/ # INPUT: immutable, untrusted source material
│ ├── documents/ │ ├── CONTRACT.md # Date shard, capture fields, immutability, untrusted content
│ ├── 2026/09/ # Where `raw accept` puts a file: the month it was accepted
│ ├── articles/ # Pre-#67 type directories: still valid paths, never moved,
│ ├── documents/ # but nothing new is ever routed into them again
│ ├── notes/ │ ├── notes/
│ └── assets/ │ └── assets/
├── raw/ # INPUT: immutable, untrusted source material
│ ├── CONTRACT.md # Routing, immutability, untrusted content, incoming/
│ ├── articles/ # Web articles, blog posts
│ ├── documents/ # PDFs, specs, manuals
│ ├── notes/ # Personal notes, transcriptions
│ └── assets/ # Images, diagrams, binaries
├── types/ # SCHEMA: the global type surface. Not a collection ├── types/ # SCHEMA: the global type surface. Not a collection
│ ├── type-spec.md # Root contract: anatomy, placement, adding a type │ ├── type-spec.md # Root contract: anatomy, placement, adding a type
│ ├── entity.md # Entity type contract + template (+ .schema.yaml) │ ├── entity.md # Entity type contract + template (+ .schema.yaml)
@@ -165,11 +162,14 @@ working *on* that layer, the contract is what binds an agent working *with* it.
### Adding Knowledge (Ingest) ### Adding Knowledge (Ingest)
1. Drop a file into `incoming/<type>/` (`articles`, `documents`, `notes`, or `assets`) - 1. Drop a file into `incoming/` - flat, no classification to make. Everything past that
the directory you choose is the only classification you make; everything past it (the destination in `raw/`, which is a `YYYY/MM` shard of the day it was accepted,
(the destination in `raw/`, whether several files of one source get bundled) is and whether several files of one source get bundled) is computed by
computed by `tools/wikitool raw accept`, never chosen by hand `tools/wikitool raw accept`, never chosen by hand
2. Tell the LLM: `Ingest incoming/articles/my-article.md` 2. Tell the LLM: `Ingest incoming/my-article.md`. It will ask you two things before
promoting: how faithful the capture is (`fidelity`) and what the material may claim
about its subject (`authority`). Both are recorded once and never guessed - they are
knowable now and unrecoverable later
3. The LLM will: 3. The LLM will:
- Promote it into `raw/` with `raw accept` - Promote it into `raw/` with `raw accept`
- Read and summarize the source - Read and summarize the source
@@ -222,7 +222,7 @@ tools/wikitool types describe entity
### For You (Human) ### For You (Human)
1. **Curate sources** - Drop files you want processed into `incoming/<type>/` 1. **Curate sources** - Drop files you want processed into `incoming/` (flat)
2. **Ask questions** - Query the wiki naturally 2. **Ask questions** - Query the wiki naturally
3. **Review changes** - Check `kb/log.md` and `kb/index.md` 3. **Review changes** - Check `kb/log.md` and `kb/index.md`
4. **Direct the LLM** - Guide it on what to emphasize or investigate 4. **Direct the LLM** - Guide it on what to emphasize or investigate
@@ -252,7 +252,7 @@ decay math, publishing) is delegated to `tools/wikitool` - never hand-edited.
1. Read `AGENTS.md` - the control plane (invariants, routing, gates) - then the stage contract 1. Read `AGENTS.md` - the control plane (invariants, routing, gates) - then the stage contract
for whichever of `raw/`, `types/` or `kb/` you are working in, and, inside `kb/`, the for whichever of `raw/`, `types/` or `kb/` you are working in, and, inside `kb/`, the
`COLLECTION.md` of the collection you are writing to `COLLECTION.md` of the collection you are writing to
2. Add your first source to `incoming/<type>/` 2. Add your first source to `incoming/`
3. Run: `Ingest <your-file>` 3. Run: `Ingest <your-file>`
4. Review the created pages 4. Review the created pages
5. Ask your first query 5. Ask your first query
@@ -261,11 +261,11 @@ decay math, publishing) is delegated to `tools/wikitool` - never hand-edited.
```bash ```bash
# Add a source # Add a source
cp ~/Downloads/my-notes.md incoming/notes/my-notes.md cp ~/Downloads/my-notes.md incoming/my-notes.md
# Tell the LLM to process it # Tell the LLM to process it
# (in your LLM agent) # (in your LLM agent)
Ingest incoming/notes/my-notes.md Ingest incoming/my-notes.md
``` ```
## Tips ## Tips