AGENTS.md

AGENTS

` near the top. - Update existing notes when the concept is the same recurring container. - Create a new note when the incident, decision, or pattern deserves its own history.

Closed Akashic Agent Rules

Closed Akashic is a maintained private memory store, not a dump folder.

Default behavior

  1. Read Closed Akashic before major work.
  2. Reuse existing notes before writing a parallel explanation.
  3. Write back one compact note or one precise update after meaningful work.
  4. Keep notes small, linked, and reusable.
  5. Prefer doc/ for durable operating docs, personal_vault/ subfolders for working memory, and assets/images/ for uploaded images.

Remote access

  • Site: https://knowledge.openakashic.com
  • Authenticated API: https://knowledge.openakashic.com/api/*
  • Authenticated MCP: https://knowledge.openakashic.com/mcp
  • Bearer token env var for local agents: CLOSED_AKASHIC_TOKEN

Writing rules

  • Stay inside doc/, personal_vault/, or assets/.
  • Preserve frontmatter shape.
  • Use ## Summary near the top.
  • Update existing notes when the concept is the same recurring container.
  • Create a new note when the incident, decision, or pattern deserves its own history.

Folder hints

  • personal_vault/concepts/
  • personal_vault/architecture/
  • personal_vault/playbooks/
  • personal_vault/schemas/
  • personal_vault/incidents/
  • personal_vault/decisions/
  • personal_vault/experiments/
  • personal_vault/reference/
  • assets/images/

Good write-back targets

  • incident
  • pattern
  • decision
  • playbook
  • experiment

See doc/agent.md for the longer rationale and workflow.