---
slug: note-discipline
title: Note Discipline — How the AI Team Writes Docs
category: capability
status: published
tags: [note, discipline, doc, writing, memory, rule, lesson, knowledge, 文档规范]
aliases: [note-discipline, doc-standards, writing-rules]
lastEditAt: 2026-06-02
---
**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.