Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 0 additions & 25 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
- `AGENTS.md` is our constitution. Propose useful amendments.
- Resilient parser with user-friendly error messages called "diagnostics" (see `diagnostics/`)
- Stability via invariants: `panic!`/`assert!`/`.expect()` for simple cases, `invariants.rs` otherwise
- AI agents create ADRs when architectural decisions are made

# Documentation

Expand Down Expand Up @@ -141,29 +140,6 @@ A = (foo (B)) B = (bar (A)) ; OK: descends each step

Tree-sitter: `((a) (b))` — Plotnik: `{(a) (b)}`. The #1 syntax error.

# Architecture Decision Records (ADRs)

- **Location**: `docs/adr/`
- **Naming**: `ADR-XXXX-short-title-in-kebab-case.md` (`XXXX` is a sequential number).
- **Index**:
- _(no ADRs yet)_
- **Template**:

```markdown
# ADR-XXXX: Title

- **Status**: Proposed | Accepted | Deprecated | Superseded by [ADR-YYYY](ADR-YYYY-...)
- **Date**: YYYY-MM-DD

## Context

## Decision

## Consequences

- **Positive** | **Negative** | **Alternatives Considered**
```

# Project Structure

```
Expand All @@ -185,7 +161,6 @@ crates/
plotnik-langs/ # Tree-sitter language bindings
plotnik-macros/ # Proc macros
docs/
adr/ # Architecture Decision Records
binary-format/ # Bytecode format specification
lang-reference.md # Language specification
```
Expand Down
3 changes: 1 addition & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Plotnik is a strongly-typed pattern matching language for tree-sitter syntax tre
## Document Map

```
AGENTS.md # Project constitution (coding rules, testing, ADRs)
AGENTS.md # Project constitution (coding rules, testing)
docs/
├── README.md # You are here
├── cli.md # CLI tool usage guide
Expand Down Expand Up @@ -58,4 +58,3 @@ Building tooling:
Contributing:

1. `AGENTS.md` — Required reading
2. ADRs in `docs/adr/` — Architectural context
52 changes: 0 additions & 52 deletions docs/adr/README.md

This file was deleted.