concept

AGENTS

AGENTS

Instructions for any AI agent reading, writing, or maintaining this repository.

Core principles

  • Markdown is the canonical knowledge format; Git is the source of truth for history.
  • Prefer [[wikilinks]] over duplicating explanations. See 00-system/conventions for the exact linking convention (plain-name links for uniquely aliased entities, path-qualified links for index.md files).
  • A fact should have one canonical home. If you find the same fact in two places, consolidate it into the canonical location and replace the duplicate with a link.
  • Do not fabricate knowledge, events, or people to fill in gaps. Leave a section incomplete or ask, rather than inventing plausible-sounding content.

Daily Notes ownership (01-daily-notes/)

01-daily-notes/ is human-owned.

AI agents MAY read files under 01-daily-notes/ when required for an authorized task.

AI agents MUST NOT:

  • create daily notes on AndrĂ©'s behalf unless explicitly requested;
  • edit them;
  • append to them;
  • rewrite them;
  • reformat them;
  • normalize them;
  • delete them.

Daily Notes represent André's original personal record and must remain intact.

Daily Logs ownership (02-daily-logs/)

02-daily-logs/ is AI-owned. Daily Logs are the AI's structured record of what happened on a given day, consolidated from conversations and other authorized sources. They should link out to canonical knowledge rather than duplicate it. See Daily Logs.

Retrieval rules for agents

When looking for knowledge:

  1. Identify the likely BU/domain.
  2. Start from the nearest index.md.
  3. Search filenames and frontmatter titles/descriptions.
  4. Follow relevant [[wikilinks]].
  5. Search full text when needed.
  6. Prefer canonical current-state documents over Daily Logs.
  7. Consult Daily Logs when historical chronology matters.
  8. Consult Daily Notes only when explicitly relevant and authorized.
  9. Do not assume that a mention in an old Daily Log still represents current truth.
  10. Preserve links between newly created knowledge and its related entities.

This structure is intentionally designed to support graph-based/agentic retrieval before introducing embeddings or vector search.

Writing rules

  • Use the templates in Templates as the starting point for new documents.
  • Use only tags from Taxonomy unless no existing tag fits.
  • Follow 00-system/privacy before copying any personal or sensitive content.
  • When consolidating a fact from a Daily Log into canonical knowledge, link back rather than leaving the fact duplicated in both places.