|
1 | | -# Spec Loop Tutorial: You Send, You See |
| 1 | +# Online Art Game Tutorial: You Send, You See |
2 | 2 |
|
3 | 3 | This tutorial is intentionally compact and execution-focused. |
4 | 4 | It is optimized to demonstrate a broad range of Spec Loop mechanisms in |
@@ -186,6 +186,8 @@ Each following tutorial step uses the same structure: |
186 | 186 | - ‘You send’ shows a suitable message to send to the LLM. Any equivalent wording is fine. |
187 | 187 | - This tutorial assumes `glossary.adoc` is created in |
188 | 188 | Step 1 and then maintained throughout the later steps. |
| 189 | + Once it exists, the LLM should treat it as ordinary project context |
| 190 | + rather than needing that reminder in every later prompt. |
189 | 191 | - Governance and workflow gates (from the copied [AGENTS.md](../AGENTS.md) and |
190 | 192 | [CONSTITUTION.md](../CONSTITUTION.md)) are expected to be loaded by your LLM tool |
191 | 193 | automatically. [glossary-skill.md](../glossary-skill.md) is expected next to |
@@ -223,6 +225,19 @@ always ask it to check the task or subtask against |
223 | 225 | If you notice files in the change set that should be ignored, you can |
224 | 226 | tell the LLM to fix that. |
225 | 227 |
|
| 228 | +## Possible misalignment |
| 229 | + |
| 230 | +If one of these happens, interrupt the flow and ask the LLM to correct |
| 231 | +it before you continue: |
| 232 | + |
| 233 | +- Implementation starts before explicit approval. |
| 234 | +- Unrelated changes are mixed into one subtask. |
| 235 | +- Implementation changes are made without verification evidence. |
| 236 | +- A supporting artifact such as `glossary.adoc`, task status, or ignore |
| 237 | + rules was not updated when the change clearly requires it. |
| 238 | +- A task or subtask is moved to `done` without explicit user |
| 239 | + confirmation. |
| 240 | + |
226 | 241 | ## Step 1: Project README ([README.md](../README.md)) |
227 | 242 |
|
228 | 243 | ### You send |
@@ -459,7 +474,6 @@ Reuse earlier task-file research where relevant, but keep future |
459 | 474 | subtasks lightweight. We will flesh out only the current subtask before |
460 | 475 | implementation. |
461 | 476 |
|
462 | | -Use `glossary.adoc` as the terminology reference. |
463 | 477 | ``` |
464 | 478 |
|
465 | 479 | ### You see (plan) |
@@ -540,8 +554,8 @@ subtask. Create only: |
540 | 554 | Keep future implementation subtasks lightweight. We will flesh out only |
541 | 555 | the current subtask before implementation. |
542 | 556 |
|
543 | | -Use `glossary.adoc` during planning as the reference for leaderboard |
544 | | -terms and definitions. |
| 557 | +Keep leaderboard terminology aligned with the established project |
| 558 | +language. |
545 | 559 | ``` |
546 | 560 |
|
547 | 561 | ### You see (plan) |
@@ -669,11 +683,3 @@ How to think while running this tutorial: |
669 | 683 | - Chat is for coordination and approvals; task files and ADRs are the |
670 | 684 | durable specification artifacts. |
671 | 685 | - Only the user may relax or override Constitution workflow rules. |
672 | | - |
673 | | -Common anti-patterns: |
674 | | - |
675 | | -- Implementation starts before explicit approval. |
676 | | -- Unrelated changes are mixed into one subtask. |
677 | | -- Implementation changes are made without verification evidence. |
678 | | -- A task or subtask is moved to `done` without explicit user |
679 | | - confirmation. |
|
0 commit comments