ObneyAI/orc / .agents/skills/elicit
elicit
VerifiedRun a structured discovery session to build an Allium specification through conversation. Use when the user wants to create a new spec from scratch, elicit or gather requirements, capture domain behaviour, specify a feature or system, define what a system should do, or is describing functionality and needs help shaping it into a specification.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 19.6 KB |
| references/assumption-checking.md | markdown | 3.2 KB |
| references/detail-elicitation.md | markdown | 4.1 KB |
| references/library-spec-signals.md | markdown | 4.7 KB |
| references/obstacle-elicitation.md | markdown | 4.9 KB |
| references/process-discovery.md | markdown | 5.7 KB |
references/detail-elicitation.md
View on GitHub# Detail elicitation
Use these techniques when an entity has a lifecycle (transition graph) but needs rules, surfaces, fields and data dependencies filled in. The shape is known; the detail isn't.
## Start from examples, not abstractions
Before writing rules, collect concrete scenarios. Ask for at least two specific cases.
"Give me a case where someone was hired. Now give me one where they were rejected at screening. What was different?"
The differences between the cases reveal the `requires` guards. The commonalities reveal the `ensures` outcomes. Rules emerge from comparing scenarios rather than being defined in the abstract.
When a rule is ambiguous or the user can't articulate the conditions, ask for more examples. "Can you give me a case where this went a different way?" Each new example narrows the rule.
## Actor walkthrough
Pick a specific human actor and walk through their perspective in first person. For system actors (external APIs, background services), use third person instead: "The payment gateway receives a charge request. What does it need? What does it return?"
"You're the recruiter. You open the system on Monday morning. What's in front of you?" The answer is surface `exposes` — the data the actor sees.
"What can you do from here?" The answer is surface `provides` — the actions available.
"When would this action not be available?" The answer is the `when` guard on the provides clause.
"After you've done that, what happens next? Who takes over?" The answer reveals the handoff to the next actor and the next surface.
## Trace data flow backward
When you encounter a decision point or a rule with preconditions, work backward from the requirement.
"The hiring manager needs to see interview feedback before deciding. Where does that feedback come from? Who provides it? At what point in the process?"
Each "where does this come from?" reveals a data dependency. Follow the chain until you reach a surface where an actor enters the data or an external system provides it. If the chain ends without a source, you've found a gap — a `missing_producer` in checker terms.
## Ground abstract descriptions
When a user describes something abstractly ("the system shows relevant information"), ground it with a concrete question.
"If you were looking at the screen right now, what would you see? What specific information?" This surfaces the exact fields that need to be in `exposes`.
"Can you sketch what that screen looks like, in words? What's at the top? What's the main content?"
## Prompt for external system boundaries
When a step depends on data from outside the system, ask how it enters.
"You mentioned the background check results come back. How does that happen? Does someone enter them manually, or does an external service send them automatically?"
The answer determines whether you need a surface facing a human actor or a contract integration point facing a system. Many process gaps involve external systems (payment processors, identity verification, notification services) where the spec needs an entry point but the user assumes the data just appears.
## What to produce
If an entity's transition graph has grown beyond eight or so states, consider whether the lifecycle should be split. A booking entity that spans request, rental, inspection and deposit settlement might be clearer as separate entities linked by relationships. Ask the user: "This entity is covering a lot of ground. Would it be clearer to separate the [X] phase from the [Y] phase into its own entity?"
At the end of detail elicitation for an entity, you should have:
- **Fields** with types, including state-dependent fields (`when` clauses)
- **Rules** witnessing every transition, with `requires` and `ensures`
- **Surfaces** for each actor that interacts with this entity, with `exposes` and `provides`
- **Relationships** connecting this entity to related entities
- **Config** for any variable values (durations, thresholds, limits)
- **Open questions** for anything unresolved
Write the spec, then describe what it says in domain language and verify it with the user before moving on (see [assumption checking](assumption-checking.md)).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |