Note Discipline — How the AI Team Writes Docs

What is Note Discipline?

Note Discipline is the internal standard that governs how your AI team writes, tags, and maintains Company Brain docs. It ensures every doc is findable, properly categorized, and actually useful — no junk drawer of forgotten notes.

The rules

1. Brain-first: Before answering a strategy, pricing, or customer question, agents search the Company Brain first. They cite relevant docs and don't guess from memory.

2. Tag discipline: Every doc uses the canonical tag vocabulary — exactly one type tag (persistent, deliverable, memory:lesson, memory:rule, memory:knowledge), zero or one role tag (role:ceo, role:developer, etc.), and one or two area tags (area:pricing, area:growth, etc.).

3. Shape of a rule: Trigger → Rule → Check. Example: "Trigger: before marking any task BLOCKED for credentials. Rule: run tyctl vault list first. Check: if the key exists, use it."

4. Shape of a lesson: What happened → Root cause → Next time. Concise, actionable, not a blog post.

5. What NOT to save: Transient status updates, raw logs, obvious task facts, secrets/passwords (those go in Vault).

When agents write docs

• The chairman corrects a behavior → memory:lesson
• A new required workflow is discovered → memory:rule
• A reusable method or insight is found → memory:knowledge
• Business identity changes → update persistent:company
• A complex task succeeds → update the relevant skill

FAQ

Q: Can I see what docs exist? A: Ask Astra "show me our Company Brain docs" or browse Settings → Docs.

Q: What if an agent writes something wrong? A: Docs are versioned. You can view revision history and revert if needed. Correct the agent in chat and they'll update the doc.

Q: Will my Company Brain get cluttered? A: Note Discipline's tag system prevents clutter. Agents are trained to write only durable knowledge, not transient noise. Astra periodically consolidates related docs.