Skip to content

Commit e47b954

Browse files
gmoonclaude
gmoon
and
claude
committed
Update SKILL.md and prompt templates for v0.2.x
- Add Message node type (MSG-*) to node types table and adding examples - Add rebuts, concedes, grounded_in to edge types table - Add health, assess, freshness commands to quick reference - Update edge type names (supports→supported_by, derives→derives_from) - Add contested thesis status mention - Update LATTICE_CLAUDE_MD.md and LATTICE_MCP_CLAUDE_MD.md prompt templates Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent a372703 commit e47b954

3 files changed

Lines changed: 65 additions & 54 deletions

File tree

‎prompts/LATTICE_CLAUDE_MD.md‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,44 @@
11
# Lattice Integration
22

3-
This project uses [Lattice](https://github.com/forkzero/lattice) for requirements tracking. The `.lattice/` directory contains the knowledge graph.
3+
This project uses [Lattice](https://github.com/forkzero/lattice) for knowledge coordination. The `.lattice/` directory contains the knowledge graph — sources, theses, requirements, implementations, and messages connected by version-tracked edges.
44

55
## Quick Reference
66

77
```bash
8-
lattice summary # Status overview
8+
lattice summary # Status overview (nodes, resolution, drift)
9+
lattice health # Unified PASS/WARN/FAIL health check
910
lattice list requirements # All requirements
10-
lattice list requirements --status unresolved # Open work
11-
lattice get REQ-XXX-001 # Full details
12-
lattice plan # What to work on next
13-
lattice drift # Check for stale edges
11+
lattice list messages # All messages
12+
lattice get REQ-XXX-001 # Full details with edges
13+
lattice search -q "keyword" # Text search
14+
lattice plan REQ-A REQ-B # Implementation order
15+
lattice drift # Check for stale edge bindings
16+
lattice help concepts # Node types, edge semantics, versioning
1417
```
1518

1619
## When Working on Features
1720

18-
1. **Before starting**: `lattice plan` to see prioritized work
21+
1. **Before starting**: `lattice summary` and `lattice plan` to see prioritized work
1922
2. **Reference requirements** in commits: `Implements REQ-XXX-001`
20-
3. **After completing**: `lattice resolve REQ-XXX-001 verified`
21-
22-
## Adding New Requirements
23-
24-
```bash
25-
lattice add requirement \
26-
--id REQ-FEAT-001 \
27-
--title "Short description" \
28-
--body "Detailed specification" \
29-
--priority P1 \
30-
--category FEAT \
31-
--derives-from THX-XXX
32-
```
23+
3. **After completing**: `lattice resolve REQ-XXX-001 --verified`
24+
4. **Verify**: `lattice drift` to confirm no stale edges
3325

3426
## Node Types
3527

3628
| Type | Purpose | ID Pattern |
3729
|------|---------|------------|
3830
| Source | Research/references | `SRC-XXX` |
39-
| Thesis | Strategic claims | `THX-XXX` |
31+
| Thesis | Strategic claims (can be `contested`) | `THX-XXX` |
4032
| Requirement | Specifications | `REQ-XXX-NNN` |
4133
| Implementation | Code bindings | `IMP-XXX-NNN` |
34+
| Message | Persona-specific claims | `MSG-XXX-NNN` |
35+
36+
## Key Edge Types
37+
38+
- `supported_by`, `derives_from`, `satisfies`, `depends_on` (traceability)
39+
- `reveals_gap_in`, `challenges`, `validates` (feedback)
40+
- `rebuts`, `concedes` (adversarial debate)
41+
- `grounded_in` (message → thesis)
4242

4343
## Resolution States
4444

‎prompts/LATTICE_MCP_CLAUDE_MD.md‎

Lines changed: 15 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,28 @@
11
# Lattice Integration (MCP)
22

3-
This project uses [Lattice](https://github.com/forkzero/lattice) for requirements tracking via MCP.
3+
This project uses [Lattice](https://github.com/forkzero/lattice) for knowledge coordination via MCP. The `.lattice/` directory contains sources, theses, requirements, implementations, and messages connected by version-tracked edges.
44

55
## MCP Tools
66

77
| Tool | Purpose |
88
|------|---------|
9-
| `lattice_summary` | Status overview (start here) |
10-
| `lattice_search` | Find nodes by criteria |
11-
| `lattice_get` | Full node details |
12-
| `lattice_list` | List nodes by type |
13-
| `lattice_resolve` | Mark requirement status |
9+
| `lattice_summary` | Status overview — nodes, resolution, drift, contested theses |
10+
| `lattice_search` | Find nodes by criteria (text, priority, resolution, tags) |
11+
| `lattice_get` | Full node details with edges |
12+
| `lattice_list` | List nodes by type (sources, theses, requirements, implementations, messages) |
13+
| `lattice_resolve` | Mark requirement status (verified, blocked, deferred, wontfix) |
1414
| `lattice_add_requirement` | Create new requirement |
15-
| `lattice_drift` | Check for stale edges |
15+
| `lattice_drift` | Check for stale edge bindings |
1616

17-
## Common Searches
17+
## Node Types
1818

19-
```json
20-
// Open P0 requirements
21-
{"resolution": "unresolved", "priority": "P0"}
22-
23-
// All API requirements
24-
{"id_prefix": "REQ-API"}
25-
26-
// Requirements related to a node
27-
{"related_to": "REQ-CORE-001"}
28-
29-
// Tagged items
30-
{"tags": ["mvp", "core"]}
31-
```
19+
| Type | ID Pattern | Purpose |
20+
|------|-----------|---------|
21+
| Source | `SRC-*` | Research, papers, references |
22+
| Thesis | `THX-*` | Strategic claims (can be `contested`) |
23+
| Requirement | `REQ-*` | Testable specifications |
24+
| Implementation | `IMP-*` | Code that satisfies requirements |
25+
| Message | `MSG-*` | Persona-specific claims grounded in theses |
3226

3327
## Workflow
3428

‎skills/lattice/SKILL.md‎

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,20 +13,27 @@ The key words MUST, MUST NOT, SHOULD, SHOULD NOT, and MAY in this document are t
1313
## Quick Reference
1414

1515
```bash
16-
lattice summary # Status overview (counts, drift, health)
17-
lattice list requirements # All requirements
18-
lattice list requirements -s active --format json # Filtered, JSON output
19-
lattice get REQ-XXX-001 # Full node details with edges
20-
lattice plan REQ-A REQ-B # Implementation order for requirements
16+
# Health & Analysis
17+
lattice summary # Status overview (counts, drift, messages, contested)
18+
lattice health # Unified PASS/WARN/FAIL verdict
19+
lattice health --check # CI gate — exits 2 on FAIL
2120
lattice drift # Check for stale edge bindings
21+
lattice freshness # Check if lattice is updated alongside code
22+
lattice assess # Change pressure (contested theses, drift)
2223
lattice lint # Structural issues
24+
lattice plan REQ-A REQ-B # Implementation order for requirements
25+
26+
# Query
27+
lattice list requirements # All requirements
28+
lattice list messages # All messages
29+
lattice get REQ-XXX-001 # Full node details with edges
2330
lattice search -q "keyword" # Text search (defaults to requirements)
31+
32+
# Modify
2433
lattice edit REQ-XXX --title "..." # Edit node fields (auto-bumps version)
2534
lattice add edge --from IMP-XXX --type satisfies --to REQ-XXX # Wire edges
26-
lattice remove edge --from IMP-XXX --type satisfies --to REQ-XXX # Remove edges
27-
lattice replace edge --from IMP-XXX --type satisfies --old-to REQ-OLD --new-to REQ-NEW # Retarget edges
28-
lattice update # Self-update to latest version
29-
lattice update --check # Check for updates without installing
35+
lattice remove edge --from IMP-XXX --type satisfies --to REQ-XXX
36+
lattice replace edge --from IMP-XXX --type satisfies --old-to REQ-OLD --new-to REQ-NEW
3037
```
3138

3239
## Editing Rules
@@ -72,21 +79,25 @@ gh issue create --repo forkzero/lattice \
7279
| Type | ID Pattern | Purpose |
7380
|------|-----------|---------|
7481
| Source | `SRC-XXX` | Research, papers, references |
75-
| Thesis | `THX-XXX` | Strategic claims backed by sources |
82+
| Thesis | `THX-XXX` | Strategic claims backed by sources (can be `contested`) |
7683
| Requirement | `REQ-XXX-NNN` | Testable specifications derived from theses |
7784
| Implementation | `IMP-XXX-NNN` | Code that satisfies requirements |
85+
| Message | `MSG-XXX-NNN` | Persona-specific claims grounded in theses |
7886

7987
## Edge Types
8088

8189
| Edge | Direction | Meaning |
8290
|------|----------|---------|
83-
| `supports` | Source → Thesis | Evidence backing a claim |
84-
| `derives` | Thesis → Requirement | Specification from strategy |
91+
| `supported_by` | Thesis → Source | Evidence backing a claim |
92+
| `derives_from` | Requirement → Thesis | Specification from strategy |
8593
| `satisfies` | Implementation → Requirement | Code fulfills spec |
8694
| `depends_on` | Requirement → Requirement | Dependency ordering |
8795
| `reveals_gap_in` | Implementation → Requirement/Thesis | Discovered underspecification |
8896
| `challenges` | Any → Thesis | Contradictory evidence |
8997
| `validates` | Implementation → Thesis | Confirming evidence |
98+
| `rebuts` | Thesis → Thesis | Adversarial debate — direct counter-argument |
99+
| `concedes` | Thesis → Thesis | Partial agreement in debate |
100+
| `grounded_in` | Message → Thesis | Messaging claim traces to strategic position |
90101

91102
## Resolution States
92103

@@ -118,6 +129,12 @@ lattice add implementation \
118129
--test-command "cargo test" --satisfies REQ-FEAT-001 \
119130
--created-by "agent:claude"
120131

132+
lattice add message \
133+
--id MSG-DEV-001 --title "Zero infrastructure" \
134+
--body "File-based YAML, no servers needed" \
135+
--persona developer --grounded-in THX-XXX \
136+
--created-by "agent:claude"
137+
121138
lattice add edge \
122139
--from IMP-XXX --type validates --to THX-XXX \
123140
--rationale "Implementation confirms thesis"

0 commit comments

Comments
 (0)