File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change 33- ` AGENTS.md ` is our constitution. Propose useful amendments.
44- Resilient parser with user-friendly error messages called "diagnostics" (see ` diagnostics/ ` )
55- Stability via invariants: ` panic! ` /` assert! ` /` .expect() ` for simple cases, ` invariants.rs ` otherwise
6- - AI agents create ADRs when architectural decisions are made
76
87# Documentation
98
@@ -141,29 +140,6 @@ A = (foo (B)) B = (bar (A)) ; OK: descends each step
141140
142141Tree-sitter: ` ((a) (b)) ` — Plotnik: ` {(a) (b)} ` . The #1 syntax error.
143142
144- # Architecture Decision Records (ADRs)
145-
146- - ** Location** : ` docs/adr/ `
147- - ** Naming** : ` ADR-XXXX-short-title-in-kebab-case.md ` (` XXXX ` is a sequential number).
148- - ** Index** :
149- - _ (no ADRs yet)_
150- - ** Template** :
151-
152- ``` markdown
153- # ADR-XXXX: Title
154-
155- - ** Status** : Proposed | Accepted | Deprecated | Superseded by [ ADR-YYYY] ( ADR-YYYY-... )
156- - ** Date** : YYYY-MM-DD
157-
158- ## Context
159-
160- ## Decision
161-
162- ## Consequences
163-
164- - ** Positive** | ** Negative** | ** Alternatives Considered**
165- ```
166-
167143# Project Structure
168144
169145```
@@ -185,7 +161,6 @@ crates/
185161 plotnik-langs/ # Tree-sitter language bindings
186162 plotnik-macros/ # Proc macros
187163docs/
188- adr/ # Architecture Decision Records
189164 binary-format/ # Bytecode format specification
190165 lang-reference.md # Language specification
191166```
Original file line number Diff line number Diff line change @@ -20,7 +20,7 @@ Plotnik is a strongly-typed pattern matching language for tree-sitter syntax tre
2020## Document Map
2121
2222```
23- AGENTS.md # Project constitution (coding rules, testing, ADRs )
23+ AGENTS.md # Project constitution (coding rules, testing)
2424docs/
2525├── README.md # You are here
2626├── cli.md # CLI tool usage guide
@@ -58,4 +58,3 @@ Building tooling:
5858Contributing:
5959
60601 . ` AGENTS.md ` — Required reading
61- 2 . ADRs in ` docs/adr/ ` — Architectural context
Load Diff This file was deleted.
You can’t perform that action at this time.
0 commit comments