Brummel
808044c0cf
Fifth skill via the boss pattern. fieldtest empirically tests whether a shipped cycle is usable by a downstream consumer who has only the public interface. Profile gains two slots: - `paths.public_interface` — list of dirs/files the fieldtester may read (the project's outward-facing surface: README, design ledger, docs, examples) - `paths.fieldtest_examples` — where the fieldtester writes its fixtures The forbidden zone is derived: everything not in `paths.public_interface` (especially `paths.code_roots` and `paths.bench_dir`) is closed to the fieldtester. This is the load-bearing source-isolation discipline. Vocabulary substitutions: - AILang → "this project" - milestone → cycle - Boss → orchestrator - ailang-fieldtester → fieldtester - "AIL Surface form / .ail" → "the project's canonical authoring or consumer form" - "design/INDEX.md + design/models/" → `paths.public_interface` - "crates/, runtime/, bench/" → `paths.code_roots`, `paths.bench_dir` AILang-specific bits dropped: - The form-a-default-authoring milestone history (2026-05-13) and the eight `.ail.json` carve-outs — AILang-specific schema-migration detail; the universal rule is just "canonical authoring form only" - The ail check / ail build / ail emit-ir CLI commands — the fieldtester now uses "the project's user-facing entry point" - Per-iter journals reference — replaced with recent iter commit bodies (universal) - Example ideas calibrated to AILang (FizzBuzz, Newton's method on Float, JSON-tree depth, ADT functors) — generalised to "realistic tasks an end-user might be asked to do" - `design/contracts/0004-feature-acceptance.md` cross-ref — dropped (AILang-specific contract); the empirical-vs- prospective brainstorm symmetry survives in prose Universal substance preserved verbatim: - All three Iron Law clauses (public-interface-only, canonical-form-only, record-don't-fix) - Five-phase process structure - Four-class finding taxonomy (bug / friction / spec_gap / working) - Spec template - Status protocol (DONE / DONE_WITH_CONCERNS / NEEDS_CONTEXT / BLOCKED) - All 8 Common Rationalisations rows (vocabulary-substituted) - All 10 Red Flags bullets (vocabulary-substituted, with the AILang-specific .ail.json hand-write bullet generalised to "intermediate representations") The source-isolation contract (Iron Law clause 1) is the load-bearing discipline. Profile slot `paths.public_interface` makes it machine-checkable; the agent's hard limit on opening paths outside that list is the discipline.
66 lines
2.6 KiB
YAML
66 lines
2.6 KiB
YAML
# Project profile for the skills plugin.
|
|
#
|
|
# Drop a copy of this file at <project-root>/.claude/dev-cycle-profile.yml
|
|
# and edit. See ~/dev/skills/docs/profile-schema.md for the full schema
|
|
# and per-key documentation.
|
|
|
|
paths:
|
|
spec_dir: docs/specs
|
|
plan_dir: docs/plans
|
|
# design_ledger: design/INDEX.md # optional
|
|
# design_contracts: design/contracts # optional
|
|
# design_models: design/models # optional
|
|
code_roots: [src]
|
|
# bench_dir: bench # optional
|
|
# public_interface: [README.md, docs] # what fieldtester may read; everything else is forbidden
|
|
# fieldtest_examples: examples/fieldtest # where fieldtester writes fixtures
|
|
|
|
naming:
|
|
counter_dirs: []
|
|
policy: flat # stable_per_directory_4digit | date_prefix | flat
|
|
slug_separator: "-"
|
|
|
|
commands:
|
|
build: "" # REQUIRED — e.g. "cargo build" or "npm run build"
|
|
test: "" # REQUIRED — e.g. "cargo test" or "npm test"
|
|
# lint: "" # optional
|
|
# doc_build: "" # e.g. "cargo doc --no-deps 2>&1" — used by docwriter
|
|
regression: [] # list of shell commands run by audit; non-zero exit = regress
|
|
architect_sweeps: [] # optional project-specific architect sweeps; non-zero exit = drift suspicion
|
|
|
|
vocabulary:
|
|
cycle: cycle # what a top-level work unit is called
|
|
subcycle: iteration # what a sub-unit is called
|
|
ledger_entry: contract # what one design-ledger entry is called
|
|
|
|
standing_reading:
|
|
always:
|
|
- CLAUDE.md
|
|
- "git log -10 --format=full"
|
|
by_role:
|
|
# architect: [design/contracts]
|
|
# debugger: ["git log -5 --format=full"]
|
|
|
|
git:
|
|
main_sacrosanct: true
|
|
only_orchestrator_commits: true
|
|
protected_branches: [main]
|
|
issue_tracker:
|
|
kind: none # gitea | github | linear | none
|
|
close_marker: "closes #N"
|
|
# url: "" # human-browsable issue list URL
|
|
# list_cmd: "" # e.g. "tea issues ls --repo X/Y --state open"
|
|
|
|
notifications:
|
|
# command: "" # e.g. "~/.claude/notify.sh"; boss falls back to chat if empty
|
|
|
|
pipeline:
|
|
brainstorm: { gates: [planner] }
|
|
planner: { gates: [implement] }
|
|
implement: {}
|
|
audit: { mandatory_at: cycle_close }
|
|
debug: { trigger: bug, red_first: true }
|
|
# boss: { user_invoked: true } # autonomous orchestrator mode, /boss
|
|
# fieldtest: { boss_only: true, when: surface_touch }
|
|
# docwriter: { boss_only: true, when: api_stable_across_n_cycles }
|