Getting started
Get started with the Community Legibility Spec
WikiWhy
Make your thinking legible to others.
Keep a tight pulse on what your system is doing, sending or needing.
Cancel your subscriptions.
What you will make
Your own contact card
The first file you make. Open it on your phone, or send it to anyone.
per_your-name.vcf
Before you start
Install, then open your agent in a new folder
- Node.js 18 or later ↗
- Claude Code ↗
- Kiwix ↗
- A new, empty folder
- Open your agent there
KiwixOpens a shareable sent as one packed .zim file, offline.
CheckStep 1 checks your Node.js version.
Paste into your agent
One prompt does steps 1 to 9
Fill in your name, your email and the packet's path.
Set me up with the Community Legibility Spec packet at <packet>. My name is <Your Name> and my email is <you@example.org>. Follow <packet>/SETUP.md steps 1 to 9 in this folder, in order, using the By hand commands. After each step, check the output against "You should see" and stop if it differs. Do not send anything anywhere. When you are done, show me my dashboard and tell me where my card is.
See the prompt
Set me up with the Community Legibility Spec packet at <packet>. My name is <Your Name> and my email is <you@example.org>. Follow <packet>/SETUP.md steps 1 to 9 in this folder, in order, using the By hand commands. After each step, check the output against "You should see" and stop if it differs. Do not send anything anywhere. When you are done, show me my dashboard and tell me where my card is.
Check
Your dashboard opens
You should seeYour agent works through the steps and ends with your dashboard open and the path to your card.
If notYour agent stops at the step whose output differs.
Or set it up yourself
Steps 1 to 6
01Check Node.js
02Make your folder
03Keep a note of where this came from
04Copy the skills and tell them your folders
05Add yourself
06Make your card
Or set it up yourself
Steps 7 to 11
07Start your manifest
08Add your first person
09Open your dashboard
10Share something
11End a session
Do this
Share something
This logs the send. It sends nothing.
/share I made notes/for-sam.md for First project and sent it to Sam Lee. Log the make and the send, and record it against Sam.
See the prompt
/share I made notes/for-sam.md for First project and sent it to Sam Lee. Log the make and the send, and record it against Sam.
Check
The send is logged
You should see`OK`, the `.zim` path, its `bytes` and `sha256`. A `FAIL` line names what to fix in the page; nothing is written.
ThenYour dashboard shows the exchange.
Do this
End a session
Every row is checked: still there, and when it was last active.
/map End of session: check my manifest.
See the prompt
/map End of session: check my manifest.
What it builds
One prompt, your own folder
The first row of your manifest is this packet, received from Houston Bloom. It stays on your machine.
Your call
You decide what leaves
Every folder you map starts private. A redacted copy for one person is the only file that leaves.
Where next
Read how each part works
- Getting startedEvery step's prompt.
- What a contact isOne folder per person or organization.
- What the manifest isOne row per folder you name.
- Sharing somethingWhat is logged when you send.
Getting started: https://houstonbloom.github.io/houstonbloom/cls/getting-started.html What a contact is: https://houstonbloom.github.io/houstonbloom/cls/contact.html What the manifest is: https://houstonbloom.github.io/houstonbloom/cls/manifest.html Sharing something: https://houstonbloom.github.io/houstonbloom/cls/sharing.html