keisei/KeiSeiKit-1.0
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
KeiSeiKit-1.0/_blocks
History
Parfii-bot be1a864629 feat(outcome-hook): PostToolUse:Agent backfills outcome + stubs in ledger 
Phase 4 follow-up: the outcome-backfill hook the kei-model-router
needs to learn from. Without an outcome signal the Beta posterior
sees 205 NULL rows and can never converge → router falls back to
top-tier on every spawn. This hook closes that loop.

Spawned by orchestrator as a code-implementer agent (Sonnet 4.6 by
default after the manifest refactor in cb1fdde — first dogfood proof
that the tier system works end-to-end). Agent returned cleanly with
STATUS-TRUTH MARKER `shipped: functional, stubs: 0`.

Files (3):
- `~/.claude/hooks/agent-outcome-backfill.sh` (73 LOC, /bin/sh) —
  reads PostToolUse:Agent stdin JSON, parses STATUS-TRUTH MARKER from
  `tool_response`, runs `UPDATE agents SET outcome = ?, stubs_count = ?
  WHERE id = ?` via sqlite3 CLI. Defensive on every step (never blocks,
  exits 0 on missing jq / sqlite3 / DB / marker). Bypass:
  `OUTCOME_BACKFILL_BYPASS=1`. Lives outside the kit (system-level).
- `tests/hook-outcome-backfill-test.sh` (79 LOC, /bin/sh) — 8 assertions
  cover: 4 valid outcomes, idempotent re-run, missing marker, bypass
  env, missing sqlite3 (PATH stripped). Run via
  `sh tests/hook-outcome-backfill-test.sh` → "Passed: 8 Failed: 0".
- `_blocks/path-user-hooks.md` — third path-atom following
  user-memory / user-rules convention. Resolves to `~/.claude/hooks/`.
  Lets future manifests reference hook files via
  `path:user-hooks/<file>.sh` opaquely. Registered in registry as
  `atom::md::331b9a34::023e5a08`.

Wiring:
- `~/.claude/settings.json` PostToolUse:Agent matcher chain — appended
  the hook idempotently (jq update preserves existing
  `agent-stub-scan.sh`, `task-timer.sh`, `agent-fork-done.sh`).
- DNA-INDEX regenerated; new path-atom appears in `## Atom (120)`
  section.

Effect: every Agent tool call from now on writes outcome + stubs to
ledger. After ~10-20 invocations the Beta posterior has a usable
prior; after ~50 the router stops defaulting Sonnet to Opus on
unfamiliar tasks. The advisor hook (`model-router-advisor.sh`)
already prints stderr when current model > recommended — orchestrator
needs to actually pass `model:` parameter on next spawn (behavioural,
not a code change).

=== STATUS-TRUTH MARKER ===
shipped: functional
stubs: 0
cargo-check: NOT-RUN
behaviour-verified: yes
follow-up-required:
  - PR feat/substrate-path-atoms-2026-05-01 → main when ready

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 23:24:02 +08:00
..
api-anthropic.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-apify.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-elevenlabs.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-fal-ai.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-graphql.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-openapi-first.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-rest-conventions.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
api-versioning-pagination-ratelimit.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
auth-authorization.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
auth-oauth2-oidc.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
auth-passkeys.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
auth-sessions.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
baseline.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
ci-forgejo-actions.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
ci-github-actions.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
ci-release-automation.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
ci-security-gate.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
db-drizzle.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
db-migration-hygiene.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
db-postgres.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
db-sqlite.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
db-sqlx.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-aws-ec2.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-cloudflare.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-docker.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-hetzner-cloud.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-local-only.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-modal.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
deploy-vps-generic.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
docs-architecture-diagrams.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
docs-claude-md.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
docs-decisions-adr.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
docs-readme-template.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
docs-runbook.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
domain-has-secrets.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
domain-ml-training.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
domain-paid-apis.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
evidence-grading.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
memory-protocol.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
mode-devils-advocate.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
mode-first-principles.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
mode-matrix.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
mode-maximalist.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
mode-minimalist.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
mode-skeptic.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
obs-metrics.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
obs-structured-logs.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
obs-traces.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
path-user-hooks.md feat(outcome-hook): PostToolUse:Agent backfills outcome + stubs in ledger 2026-05-01 23:24:02 +08:00
path-user-memory.md feat(path-atoms): atomize ~/.claude memory + rules path references 2026-05-01 22:29:50 +08:00
path-user-rules.md feat(path-atoms): atomize ~/.claude memory + rules path references 2026-05-01 22:29:50 +08:00
pipeline-5phase-template.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
README.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
rule-double-audit.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
rule-error-budget.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
rule-math-first.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
rule-pre-dev-gate.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
rule-pure-click-contract.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
rule-test-first.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
scraper-free-tier.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
scraper-paid-tier.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
scraper-unified-output.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
security-audit-logging.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
security-firewall-ufw.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
security-patching.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
security-ssh-hardening.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
security-tls-caddy.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-astro.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-embedded-stm32.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-fastapi-postgres.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-flutter.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-go-server.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-nextjs.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-python-ml.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-react-vite.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-rust-axum.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-rust-cli.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-sveltekit.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-swift-ios.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-swift-spm.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
stack-tailwind.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
test-e2e.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
test-fuzz.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
test-load.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00
test-property.md KeiSeiKit-public — clean state 2026-05-01 12:09:03 +08:00

README.md

_blocks/ — Composable Agent Content

Each .md file in this directory is a block: a single-concern, standalone-readable snippet that any agent manifest can include via its blocks = [...] list. The _assembler concatenates selected blocks + manifest metadata into the final agent .md that Claude Code loads.

Blocks are grouped by prefix:

Prefix Purpose
baseline, evidence-grading, memory-protocol Obligatory base — every manifest must include these
rule-* Discipline rules (pre-dev-gate, test-first, error-budget, double-audit, math-first)
mode-* Cognitive mode blocks (see below)
stack-* Language / framework constraints (Rust Axum, React Vite, Swift SPM, …)
deploy-* Deployment target rules (Modal, AWS EC2, Cloudflare, Hetzner, …)
api-* External API conventions (Apify, fal.ai, ElevenLabs, Anthropic, …)
db-* Database rules (Postgres, SQLite, Drizzle, sqlx, migrations)
auth-*, security-*, obs-*, ci-*, test-*, scraper-*, domain-*, docs-* Domain-specific rules

Cognitive mode blocks

Composable behavioural skews. Add any combination to a manifest's blocks list to stack the mode. Modes compose — e.g. mode-skeptic + mode-minimalist yields an adversarial pruner.

Block Purpose
mode-skeptic.md Doubt the conclusion until proved; flag claims without E1/E2 grade
mode-devils-advocate.md Steel-man the opposite; name the strongest objection before agreeing
mode-minimalist.md Prefer deleting over adding; justify every addition against existing code
mode-maximalist.md Explore 10× scope; return both maximum and minimum bounds; only when user invokes exploration
mode-first-principles.md Derive from invariants; cite the physical / mathematical constraint, not "best practice"

See mode-matrix.md for the agent-role × recommended-modes table used by the skills/new-agent wizard (Phase 3.6). It is the suggested starting set per role — modes remain a free pick per manifest.

Adding a new block

  1. Pick a stable prefix (existing category or a new one documented here).
  2. One concern per file. 20–50 LOC target, <200 LOC hard cap (Constructor Pattern).
  3. Imperative voice ("Do X" not "the agent should do X") — these land verbatim in agent prompts.
  4. Standalone-readable — do not assume sibling blocks are present. Cross-references OK, hard dependencies not.
  5. Reference from a manifest's blocks = [...] list; the assembler validates existence.

Ownership

Blocks are kit-owned — install.sh overwrites _blocks/ on re-run, backing up local edits to _blocks.bak-TIMESTAMP/. User-owned content belongs in _manifests/*.toml (which are never overwritten).