feat: introduce two-phase Ingest process with manifest

This commit is contained in:
Matteo Cherubini 2026-06-09 15:27:58 +02:00
parent c0aff1ff09
commit e8dea9c8bc

View file

@ -89,18 +89,23 @@ Execute in this order before any file operation:
_Triggered by new file in `raw/`._
**Phase 1 — Semantic Pass (Agent Skill)**
1. Read source once.
2. Create `wiki/sources/<slug>.md` — summary + key points.
3. Per entity (person, tool, org): create or update `wiki/entities/<name>.md`.
4. Per concept (pattern, theory, decision): create or update `wiki/concepts/<name>.md`.
5. Check each touched page for contradictions → apply §Conflict if found.
6. Append entry to `wiki/index.md` (bottom of relevant section).
7. Append log entry: `INGEST | <slug>`.
8. Run scoped lint on pages created or modified in this session. Report issues in PR description. Do not auto-fix.
9. Commit on `feat/ai-ingest-<slug>`. Open PR using `templates/pr-description.md`.
6. **Final action:** Write `.ingest-manifest.json` at the genome root.
7. **STOP.** Do not proceed to index, log, lint, commit, or PR — these are Phase 2.
**Phase 2 — Deterministic Post-Processing (`run-ingest.sh`)**
_Executed automatically by the orchestrator after Phase 1._
8. Append entry to `wiki/index.md` (bottom of relevant section).
9. Append log entry: `INGEST | <slug>`.
10. Run scoped lint on pages created or modified in this session. Report issues in PR description. Do not auto-fix.
11. Commit on `feat/ai-ingest-<slug>`. Open PR using `templates/pr-description.md`.
_Private source_ (`PRIVATE_CONTEXT: enabled` required):
- All output → `wiki/private/<slug>.md` only.
- PR title: `[PRIVATE] ingest: <slug>`.