0be354a920
Single-commit clean baseline after security scrub of niche-tells, project codenames, internal jargon, and contributor-email leaks. Contents: - 100 Rust crates (_primitives/_rust/) - 37 agent manifests (_manifests/) + generated specs (_generated/) - 67 user-invocable skills (skills/) - 33 hooks (hooks/) - Composition blocks (_blocks/) - Documentation (docs/, README.md) - TS adapter packages (_ts_packages/) - Assembler (_assembler/) - Roles (_roles/) - Templates (_templates/) - Forgejo CI (.forgejo/) Author: Denis Parfionovich <info@greendragon.info> License: see LICENSE.
42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# Pure-Click Contract
|
|
|
|
> Shared rule block — referenced by pipeline and multi-phase skills
|
|
> (ci-scaffold, auth-setup, observability-setup, docs-scaffold,
|
|
> schema-design, self-audit, sleep-on-it, and others).
|
|
|
|
## Rule
|
|
|
|
Every decision in the skill is made via `AskUserQuestion` (option-picker UI,
|
|
NOT free-text). The ONLY permitted typed input is intake — a one-line or
|
|
one-paragraph description — which is immediately classified into options on
|
|
the next phase.
|
|
|
|
## What counts as "intake" (typed input allowed)
|
|
|
|
- Phase 1 one-line description of the target repo / app / service.
|
|
- Phase 2 entity list (for `/schema-design`) — typed list of table names.
|
|
- Free-text reason for a user-declared bypass or override.
|
|
|
|
## What MUST be a click (AskUserQuestion)
|
|
|
|
- Every binary yes/no decision.
|
|
- Every "pick one of N" decision (platform, ORM, motion-tier, auth-flow).
|
|
- Every "pick subset of N" decision (sections, providers, dashboards).
|
|
- Every approve / iterate / switch / abort prompt.
|
|
- Every per-finding fix / skip / defer prompt in verify/audit phases.
|
|
|
|
## Why
|
|
|
|
- Click-driven flows are replayable and auditable — the option taken is in
|
|
the transcript, not inferred from free-form text.
|
|
- Options constrain the decision space to what the skill actually handles,
|
|
preventing silent scope creep.
|
|
- `AskUserQuestion` is the tool the harness renders as a proper picker UI;
|
|
free-text prompts degrade to plain chat.
|
|
|
|
## Non-compliance
|
|
|
|
If a skill prompts the user for a value that IS in a closed enum (e.g.
|
|
"which framework?") but does NOT use `AskUserQuestion`, that is a
|
|
contract violation. Fix by replacing the prompt with an `AskUserQuestion`
|
|
call whose `options` array lists the enum values.
|