AGENTS.md — Personal Agent Wiki Schema and Conventions¶

Read this file before any wiki ingest, query, or lint.

Layout¶

agent-wiki/
├── AGENTS.md          # this file
├── index.md           # content catalog
├── log.md             # append-only ops log
├── raw/               # source documents (immutable)
└── wiki/
    ├── entities/      # one file per Person/Org (mirrors AnyType where applicable)
    ├── projects/      # one file per tracked project (mirrors AnyType pkm_project)
    ├── events/        # one file per tracked event (mirrors AnyType event)
    ├── concepts/      # ideas, frameworks, terms
    ├── topics/        # broader subject pages
    ├── timelines/     # chronological views
    └── sources/       # one summary file per ingested source in raw/

Page conventions¶

Every wiki page has:

• YAML frontmatter:

  ---
  title: <human title>
  type: <entity|project|event|concept|topic|timeline|source>
  classification: <private_sensitive|internal|low_sensitive>
  created: <yyyy-mm-dd>
  updated: <yyyy-mm-dd>
  sources: [list of source page slugs]
  related: [list of page slugs]
  ---
  

• A 1-line summary directly under the H1.
• Body sections appropriate to type (see below).
• A ## Sources section listing the canonical references.

Page types¶

Entity¶

Sections: Identity, Affiliations, Notable contributions, Mentions, Open questions.

Concept¶

Sections: Definition, Why it matters, Variants, Related concepts, Sources.

Topic¶

Sections: Overview, Key facts, Open questions, Sub-topics, Sources.

Project¶

Sections: Identity (name, status, version, license, repo, org), Tech stack, Team, Architecture, Roadmap, External connections, Open questions.

Event¶

Sections: Date & Location, Description, Participants, Related projects, Preparation (if upcoming) / Outcomes (if past), Open questions.

Timeline¶

Sections: Period, Key events (chronological), Cross-references.

Source¶

Sections: Provenance (URL, author, date), Key takeaways, Notable quotes, Affected wiki pages, Date ingested.

Operations¶

Ingest¶

1. Read the source from raw/.
2. Discuss key takeaways with the user (or summarize them in chat for review).
3. Create wiki/sources/<slug>.md with the source page template.
4. Update affected entity / concept / topic / timeline pages — add or revise relevant sections, ensure cross-references exist both ways.
5. Update index.md — add the new source page; update modified pages' summaries if their content changed.
6. Append a row to log.md.
7. Flag contradictions explicitly (don't silently overwrite).

Query¶

1. Search index.md for relevant pages.
2. Read those pages (and their sources: references) to depth 1.
3. Synthesize an answer with citations.
4. Optionally file the answer as a new wiki page if it's a non-trivial synthesis.

Lint¶

Periodically (or on demand):

• Find pages with no inbound links (orphans).
• Find pages whose sources: list is empty.
• Find concepts mentioned in body text without their own page.
• Find contradictions between pages.
• Suggest follow-up questions or sources.

Cross-link with AnyType¶

• A wiki page can reference an AnyType object via anytype:<object_id> in frontmatter related:.
• A AnyType Project may link to a wiki page via wiki_index_id.
• Treat AnyType as authority for private_sensitive data; wiki entries for those should be redacted summaries only.

Log format¶

Append-only. Each entry begins with ## [<yyyy-mm-dd>] <op> | <subject> for grep-ability:

## [2026-05-04] ingest | <source title>
- pages updated: ...
- contradictions flagged: ...

## [2026-05-04] query | <question>
- answer filed at: ...
- pages cited: ...

## [2026-05-04] lint | full
- orphans: ...
- contradictions: ...
- suggested follow-ups: ...