docs+skills: add main UI/UX visual-truth PRD and skill links
This commit is contained in:
parent
1c36223e7f
commit
14a50ad4ae
289 changed files with 54463 additions and 0 deletions
113
.agents/skills/linus-beads-discipline/resources/BEADS_MEMORY.md
Normal file
113
.agents/skills/linus-beads-discipline/resources/BEADS_MEMORY.md
Normal file
|
|
@ -0,0 +1,113 @@
|
|||
# Beads as Shared Memory
|
||||
|
||||
**The shared brain for all Linus-agents.**
|
||||
|
||||
## The Principle
|
||||
|
||||
```
|
||||
All Linus-agents share the same beads.
|
||||
Your notes are read by other agents.
|
||||
Their notes inform your work.
|
||||
Coordinate through truth, not messages.
|
||||
```
|
||||
|
||||
## Every Session
|
||||
|
||||
### Start: READ
|
||||
```bash
|
||||
bd ready # What's unblocked?
|
||||
bd show <id> # What are the details?
|
||||
bd query "status=closed AND notes~=<topic>" # What was learned before?
|
||||
```
|
||||
|
||||
**NEVER start work without reading beads first.**
|
||||
|
||||
### During: WRITE
|
||||
```bash
|
||||
bd update <id> --notes "Progress: ...
|
||||
Evidence: ...
|
||||
Blockers: ...
|
||||
Next: ..."
|
||||
```
|
||||
|
||||
**Every meaningful progress = update.**
|
||||
|
||||
### End: SYNC
|
||||
```bash
|
||||
bd sync # Share with other agents
|
||||
```
|
||||
|
||||
**NEVER end session without syncing.**
|
||||
|
||||
## Handoff Protocol
|
||||
|
||||
### When You're Done
|
||||
```bash
|
||||
bd update <id> --notes "Handoff:
|
||||
## Completed
|
||||
- X, Y done, evidence: [gates]
|
||||
|
||||
## Incomplete
|
||||
- Z remaining
|
||||
|
||||
## For Next Agent
|
||||
- Gotcha: <non-obvious thing>
|
||||
- Pattern: <what to follow>
|
||||
- Files: <what changed>"
|
||||
```
|
||||
|
||||
### When Picking Up Another's Work
|
||||
```bash
|
||||
bd show <id> # Read their notes
|
||||
bd query "id=<id>" --comments # Read comments
|
||||
# Acknowledge their work in your first update
|
||||
bd update <id> --notes "Continuing from <agent>. Last state: ..."
|
||||
```
|
||||
|
||||
## Memory That Survives Compaction
|
||||
|
||||
When conversation is compacted, beads survives:
|
||||
|
||||
```
|
||||
Previous session:
|
||||
- bd update bb-xyz --notes "Implemented X, need tests"
|
||||
|
||||
After compaction:
|
||||
- bd show bb-xyz
|
||||
- Notes say: "Implemented X, need tests"
|
||||
- You know: Add tests
|
||||
- Zero context lost
|
||||
```
|
||||
|
||||
**This is the point. Memory that survives session boundaries.**
|
||||
|
||||
## Notes For Future Agents
|
||||
|
||||
Your notes should answer:
|
||||
- **What did you learn?** (findings)
|
||||
- **What did you decide?** (decisions + rationale)
|
||||
- **What's incomplete?** (handoff)
|
||||
- **What blocked you?** (blockers)
|
||||
- **What would help next agent?** (hints)
|
||||
|
||||
## Cross-Agent Visibility
|
||||
|
||||
```bash
|
||||
# See who else is working
|
||||
bd query "status=in_progress"
|
||||
|
||||
# See what was recently closed
|
||||
bd query "status=closed AND updated<1d"
|
||||
|
||||
# See agent activity
|
||||
bd query "labels~=gt:agent"
|
||||
```
|
||||
|
||||
## The Promise
|
||||
|
||||
By using beads religiously:
|
||||
- **No lost context** - Compaction can't kill your work
|
||||
- **No truth drift** - State always matches reality
|
||||
- **No coordination overhead** - BD coordinates for you
|
||||
- **No "what was I doing?"** - Notes tell you
|
||||
- **No "who else is working?"** - Query tells you
|
||||
Loading…
Add table
Add a link
Reference in a new issue