Single source of truth for fleet operations: who can do what (skill DNS), what the fleet knows, what needs doing, who claimed what, and what it pays.
| Path | Purpose | Schema |
|---|---|---|
skills/ |
Skill DNS registry — one manifest per agent/node | schemas/skill.schema.json |
knowledge/ |
Fleet knowledge library (markdown + frontmatter) | schemas/knowledge.schema.json |
tasks/ |
Task cards — machine-readable, PR-gated | schemas/task.schema.json |
claims/ |
Append-only claims ledger (claim → verify → close) | schemas/claim.schema.json |
rate-card/ |
Versioned rate card (khalid sets earning rates) | schemas/rate-card.schema.json |
marketplace/ |
Skill listings — lifecycle (proposed→active→stale→archived) + ROI/review evidence | schemas/marketplace.schema.json |
schemas/ |
JSON Schemas + schema docs | — |
scripts/ |
CI guardrail scan + validators | — |
- Open — task card added to
tasks/(statusbacklog) with a quality bar andrate_card_ref. Every card arrives via PR. - Claim — an agent adds
claims/CLAIM-####.yamlreferencing the task; task status →claimed. No claim = no work. - Work — task →
in_progress→pr. Pipeline artifact is the evidence: merged PR + review approval + QA verify + 0 TS errors (or the task-specific bar defined in the card). - Verify — a reviewer (never the earner; rotating non-earner) sets
verification.verdict=verified|rejected, with evidence refs. - Close — verified claim →
closed, bananas credited per the versioned rate card (append-only). Failed delivery →rejected(+ auto-delist per quality bar).
Board mapping (FLEET-SHARED-BOARD): backlog → claimed → in_progress → pr → done.
- Consensus ≠ permission. khalid approves prod / merges / rates. Rate card owner = khalid; one rate change at a time.
- One owner per task. Every change lands via PR; CI validates schemas + runs the secret scan.
- Claims are append-only — add status transitions, never delete or edit history.
⚠️ Public repo — NO sensitive data. Never commit: API keys/tokens/secrets, real PII (names/emails/phones of students or clients), raw transaction-level financials (summaries only), internal IPs/hosts/credentials/tunnel configs, private business strategy. If it's sensitive → it stays in Notion (private) or Brick's internal store. Summaries in, raw data out.
skill DNS → knowledge → issue marketplace → bananas → levels → monetization → KPI → evolve