Public Corpus Ingest Workflow
Use this workflow when the user asks for a complete public corpus such as full GitHub, projects, public releases, papers, posts, and recurring updates.
Trigger Pattern
- User asks for complete GitHub, all projects, all public releases, all papers, and recurring updates.
- User emphasizes that the corpus is important and future agents must remember the workflow.
Required Steps
- Disambiguate same-name people before crawling.
- Create separate entity pages, manifests, raw directories, and source pages for distinct identities.
- Use stable item IDs and
semantic_hashto prevent duplicate captures and noisy commits. - Use safe public indexing: metadata, summaries, links, hashes, categories, and license notes.
- Do not publicly mirror unclear-license full PDFs, source code, or long webpage text.
- Add or update an automation that reruns the ingest, validates, commits scoped changes, and pushes.
- Treat automation outputs as official wiki maintenance. If a run changes raw manifests, source pages, topic pages, analysis pages,
wiki/catalog.json,wiki/index.md, orwiki/log.md, stage those scoped outputs, commit them, and push after validation.
Validation
- Run manifest duplicate checks.
- Run
scripts/wiki-catalog.ps1,scripts/wiki-lint.ps1, andgit diff --check. - Ignore unrelated local changes such as
GetPdf.pdfunless the user explicitly asks otherwise. - Before committing, inspect
git diff --statand the relevant file diffs so generated changes are real content changes and do not leak private data. - If
git statusreports automation-managed files as modified but hashes andgit diffshow no real content changes, treat it as false dirty state from line endings or index metadata. Refresh/normalize the index and report that there was no substantive automation output to commit. - Never leave real automation output uncommitted at the end of the turn unless validation fails or the user explicitly asks to pause.
Counterpoints And Gaps
- This workflow is a default pattern, not permission to ignore source-specific licenses or identity ambiguity.
- Some public platforms block automated access; record crawl errors and use stable fallback sources instead of inventing completeness.
- Automation commits still need scope discipline: do not stage unrelated local edits just because an automation run touched nearby wiki sections.