feat: add communication style guideline

This commit is contained in:
Richard Tang
2026-02-09 19:28:48 -08:00
parent c8ee961436
commit 8f632eb005
+9 -6
View File
@@ -67,10 +67,13 @@ mkdir -p exports/AGENT_NAME/nodes
**The core principle**: Discovery should feel like progress, not paperwork. The stakeholder should walk away feeling like you understood them faster than anyone else would have. **The core principle**: Discovery should feel like progress, not paperwork. The stakeholder should walk away feeling like you understood them faster than anyone else would have.
**The #1 Rule: Respect Their Time.** Every question must earn its place by: **Communication sytle**: Be concise. Say less. Mean more. Impatient stakeholders don't want a wall of text — they want to know you get it. Every sentence you say should either move the conversation forward or prove you understood something. If it does neither, cut it.
**Ask Question Rules: Respect Their Time.** Every question must earn its place by:
1. **Preventing a costly wrong turn** — you're about to build the wrong thing 1. **Preventing a costly wrong turn** — you're about to build the wrong thing
2. **Unlocking a shortcut** — their answer lets you simplify the design 2. **Unlocking a shortcut** — their answer lets you simplify the design
3. **Surfacing a dealbreaker** — there's a constraint that changes everything 3. **Surfacing a dealbreaker** — there's a constraint that changes everything
4. **Provide Options** - Provide options to your questions if possible, but also always allow the user to type something beyong the options.
If a question doesn't do one of these, don't ask it. Make an assumption, state it, and move on. If a question doesn't do one of these, don't ask it. Make an assumption, state it, and move on.
@@ -120,7 +123,7 @@ After listening, present a **concrete picture** of what you think they need. Mak
> >
> The way I'd structure this: [key entities] connected by [key relationships], with the main flow being [trigger → steps → outcome]. > The way I'd structure this: [key entities] connected by [key relationships], with the main flow being [trigger → steps → outcome].
> >
> For v1, I'd focus on [the one thing that delivers the most value] and hold off on [things that can wait]. > For the MVP, I'd focus on [the one thing that delivers the most value] and hold off on [things that can wait].
> >
> Before I start — [1-2 specific questions you genuinely can't infer]." > Before I start — [1-2 specific questions you genuinely can't infer]."
@@ -174,7 +177,7 @@ One decision point. Yes or no. Then you're building.
| 1 | User | Describes what they need | | 1 | User | Describes what they need |
| 2 | Agent | Plays back understanding as a proposed model. Asks 1-2 critical questions max. | | 2 | Agent | Plays back understanding as a proposed model. Asks 1-2 critical questions max. |
| 3 | User | Corrects, confirms, or adds detail | | 3 | User | Corrects, confirms, or adds detail |
| 4 | Agent | Adjusts model, confirms v1 scope, states assumptions, declares starting point | | 4 | Agent | Adjusts model, confirms MVP scope, states assumptions, declares starting point |
| *(5)* | *(Only if Turn 3 revealed something that fundamentally changes the approach)* | | *(5)* | *(Only if Turn 3 revealed something that fundamentally changes the approach)* |
**If you're going in circles, you need a different question, not more questions.** **If you're going in circles, you need a different question, not more questions.**
@@ -205,9 +208,9 @@ After the conversation, produce this before moving to 2b:
> **Solution**: [what we're building, core approach] > **Solution**: [what we're building, core approach]
> **Users**: [who, how often, context — 1-2 lines] > **Users**: [who, how often, context — 1-2 lines]
> **Domain Model**: [key entities and relationships — "A Project has many Tasks. Each Task has an Owner and Status."] > **Domain Model**: [key entities and relationships — "A Project has many Tasks. Each Task has an Owner and Status."]
> **V1 Scope**: > **MVP Scope**:
> - Will build: [concrete deliverables] > - Building now: [concrete deliverables]
> - Won't build yet: [deferred items] > - Later: [deferred items]
> **Key Flow**: [trigger → steps → outcome] > **Key Flow**: [trigger → steps → outcome]
> **Assumptions**: [what you're assuming — user can correct] > **Assumptions**: [what you're assuming — user can correct]