Files
Joel Hooks 016dccc295 redesign: cool finds index — full titles, readable descriptions, compact cards
- Titles wrap fully instead of truncating
- Relevance text shows complete (no line-clamp)
- Date shown as relative time (2d ago) above title, not stealing width
- Single type badge (repo/article/video) replaces full tag list
- Source URL removed from index (shown on detail page)
- Tighter card spacing for better scan density
- Re-removed duplicate self-hosting discovery (also from Vault source)
2026-02-22 08:07:35 -08:00

1022 B

Agent Contracts

This directory holds agent-facing CLI contract artifacts (baseline snapshots, capability maps, and policy contract notes).

Shared policy workflow contract

Canonical workflow: .github/workflows/agent-contracts.yml (job: policy-validators).

This is the single shared policy workflow for contract/guard enforcement. It must include this validator set:

  1. bun run validate:cli-contracts
  2. bun run validate:llm-observability-guards
  3. bun run validate:no-legacy-worker-clone
  4. bun test packages/cli/src/commands/contract-envelope.test.ts
  5. bun test packages/cli/src/commands/capabilities.test.ts
  6. bun test packages/cli/src/commands/search.test.ts
  7. pnpm --filter @joelclaw/cli check-types

Drift policy

  • Do not split these validators into separate dedicated workflows.
  • Any change to this validator set must update:
    • .github/workflows/agent-contracts.yml
    • this docs/agent-contracts/README.md
    • ADR notes in 0093 (and 0089/0101 when applicable)