Instruction file imported from Cavga1903/firstCoffee (.cursor/rules/omni-protocol/level-12-documentation.mdc). Copyright stays with the author.

12A. Conversation Persistence & Knowledge Ledger Contract (MANDATORY)

Intent

Chat is transient. Documentation is memory. Undocumented decisions do not exist.

Scope

This contract applies to ALL conversations that include:

• architectural decisions
• governance rules (Levels 1–12)
• process definitions
• DevOps / commit / deploy protocols
• system philosophy or operating law changes

Casual conversation is excluded unless it produces a decision.

12B. Auto-Persist Rule (MANDATORY)

After EVERY qualifying conversation, the system MUST:

• extract decisions and rules
• normalize language
• persist them into documentation

If it is not written, it is considered LOST.

No reminders allowed.

12C. Documentation Targets (STRICT)

The system MUST persist outputs into the correct destination:

1. docs/governance/operating-law.md
2. docs/governance/levels/level-<N>.md
3. docs/architecture/decisions/ADR-<date>-<slug>.md
4. docs/processes/<process-name>.md
5. docs/runbooks/<area>.md

Dumping all content into a single file is FORBIDDEN.

12D. Mandatory Traceability Header

Every persisted document MUST begin with:

---
source: chat
chat_date: YYYY-MM-DD
participants: user + cursor
scope: <summary>
confidence: high | medium | exploratory
---

This establishes legal, architectural, and historical traceability.

12E. Synthesis Rule (CRITICAL)

Intent

Conversation is raw material. Documentation is refined output.

Rules

The system MUST NOT:

• paste raw chat logs
• include dialogue or speaker turns
• store unstructured conversation
• preserve conversational tone or narration

The system MUST:

• synthesize discussion into clear rules or decisions
• normalize language and terminology
• convert chat outcomes into contracts, policies, or ADRs
• remove ambiguity and informal phrasing

Chat ≠ Documentation.

🇩🇪 Gespräch ist Rohmaterial. Dokumentation ist Ergebnis.
(das Gespräch = conversation, das Ergebnis = result)

12F. Conflict Resolution Rule

Intent

History must be stable. Change must be explicit.

Rules

If new conversation output contradicts existing documentation:

• silent overwrite is FORBIDDEN
• automatic replacement is FORBIDDEN

The system MUST:

• flag the conflict clearly
• present a unified diff
• explain the impact of each option
• request explicit human confirmation

Historical mutation without consent is illegal.

🇩🇪 Änderung braucht Zustimmung.
(die Zustimmung = consent)

12G. Versioning & Auditability

Intent

Truth without history is untrustworthy.

Rules

• every documentation change MUST be committed to version control
• commits MUST reference the reason for change
• significant rule changes MUST include:
  • rationale
  • summary of previous state
  • behavioral or system impact

Unversioned documentation is invalid.

🇩🇪 Ohne Geschichte keine Wahrheit.
(die Geschichte = history)

12H. No Reminder Rule

Intent

Memory must be automatic.

Rules

The user MUST NOT need to say:

• "bunu dokümana yaz"
• "docs'a ekle"
• "kaydet"

Documentation persistence is SYSTEM responsibility.

🇩🇪 Erinnerung ist Pflicht, nicht Anfrage.
(die Pflicht = duty)

12I. Failure Condition

Intent

Incomplete persistence is failure.

Conditions

If a qualifying conversation occurs AND:

• no documentation is updated
• OR incorrect documentation target is chosen
• OR synthesis is skipped

THEN:

• the output is INVALID
• correction is MANDATORY
• persistence MUST occur immediately

🇩🇪 Fehler müssen sichtbar sein.
(sichtbar = visible)

12J. Final Principle

Chat is thinking. Documentation is truth.

Systems that do not record decisions will repeat mistakes.

🇩🇪 Gedanken vergehen. Aufzeichnungen bleiben.
(die Aufzeichnung = record)