allye-opencode 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +25 -13
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -206,9 +206,11 @@ Use this when the user talks about: requirements, business needs, product scope,
|
|
|
206
206
|
## Workflow Overview
|
|
207
207
|
|
|
208
208
|
\`\`\`
|
|
209
|
-
Understand
|
|
209
|
+
Understand intent \u2192 Search context when useful \u2192 Propose hierarchy when traceability helps \u2192 Get approval \u2192 Create items \u2192 Save decisions
|
|
210
210
|
\`\`\`
|
|
211
211
|
|
|
212
|
+
Product Planning is recommended for durable product scope, not a mandatory prerequisite for every local implementation. Never create items without explicit approval.
|
|
213
|
+
|
|
212
214
|
---
|
|
213
215
|
|
|
214
216
|
## Step 0: Check for a Discovery Doc
|
|
@@ -219,7 +221,7 @@ If you arrived via a \`discovery-to-planning\` handover (see the \`handover-prot
|
|
|
219
221
|
|
|
220
222
|
## Step 1: Understand the Business Context
|
|
221
223
|
|
|
222
|
-
Before creating anything, have a conversation with the user to understand:
|
|
224
|
+
Before proposing or creating anything, have a conversation with the user to understand:
|
|
223
225
|
|
|
224
226
|
1. **What problem are we solving?** \u2014 The business need or opportunity
|
|
225
227
|
2. **Who is it for?** \u2014 Target users or stakeholders
|
|
@@ -304,7 +306,7 @@ Epic: User Authentication System
|
|
|
304
306
|
\u2514\u2500\u2500 Story: User can log out from all devices
|
|
305
307
|
\`\`\`
|
|
306
308
|
|
|
307
|
-
Wait for the user to approve, modify, or add to this structure before proceeding.
|
|
309
|
+
Wait for the user to approve, modify, or add to this structure before proceeding. If the user explicitly chooses a no-work-item path for a small or local change, do not create a hierarchy; keep the scope and verification visible instead.
|
|
308
310
|
|
|
309
311
|
---
|
|
310
312
|
|
|
@@ -445,7 +447,7 @@ Before considering product planning complete, verify:
|
|
|
445
447
|
After items are approved and created, ask the user whether to generate a **\`planning-to-technical\`** handover (see the \`handover-protocol\` skill) for Technical Planning. Fill the template's \`Doc:\` line with the Discovery Doc reference if one exists upstream (or "Nenhum doc adicional" if not), and list every created **and** reused key \u2014 Technical Planning has no other way to know which items are which.`;
|
|
446
448
|
var TECHNICAL_PLANNING = `# Technical Planning Workflow
|
|
447
449
|
|
|
448
|
-
Turns
|
|
450
|
+
Turns an approved, meaningful story into actionable tasks through a **Discussion Phase** \u2014 surfacing gray areas, capturing decisions, and writing tasks with verifiable acceptance criteria and a runnable verification command. It is recommended for durable, multi-step, shared, or review-heavy work, not mandatory for every local change.
|
|
449
451
|
|
|
450
452
|
**Never assume \u2014 always ask.** The user knows the direction they want, sometimes only after researching further. Your job is to surface the gray areas and present real options, not to quietly pick one and present it as the plan.
|
|
451
453
|
|
|
@@ -461,6 +463,8 @@ Get story \u2192 Search context \u2192 Discussion Phase \u2192 Create tasks \u21
|
|
|
461
463
|
|
|
462
464
|
## 0. Scope: one feature, story by story
|
|
463
465
|
|
|
466
|
+
If the user explicitly chooses a no-task path, do not enter this workflow or create tasks. State the local scope, assumptions, and verification plan instead.
|
|
467
|
+
|
|
464
468
|
The steps below plan **one story at a time** \u2014 but the unit Technical Planning hands to the Orchestrator is the **feature**. When the target feature has multiple stories (a \`planning-to-technical\` handover usually lists several), work through every story under that feature in sequence, one at a time, running the full workflow (Steps 1\u20136) for each before starting the next.
|
|
465
469
|
|
|
466
470
|
**Emit only ONE \`technical-to-orchestration\` handover, at the very end \u2014 after the last story in the feature is planned, never after each individual story.** That handover must cover every story and every task, grouped by wave, which is only honest once all of the feature's stories have actually been planned. If the session ends before all stories are planned, save session state (Step 6) and resume in a fresh chat \u2014 don't emit a partial feature-level handover.
|
|
@@ -511,9 +515,9 @@ If tasks already exist, review them instead of creating new ones. The user may w
|
|
|
511
515
|
## Step 3: Discussion Phase
|
|
512
516
|
|
|
513
517
|
<EXTREMELY_IMPORTANT>
|
|
514
|
-
|
|
515
|
-
before creating any task.
|
|
516
|
-
|
|
518
|
+
For tracked work, complete the discussion phase \u2014 surfacing ambiguity before committing
|
|
519
|
+
to a plan \u2014 before creating any task. A user-approved no-task path may skip task creation,
|
|
520
|
+
but must still surface scope-changing ambiguity and define proportional verification.
|
|
517
521
|
</EXTREMELY_IMPORTANT>
|
|
518
522
|
|
|
519
523
|
### 3.1 Identify Gray Areas
|
|
@@ -528,7 +532,7 @@ Examples of gray areas:
|
|
|
528
532
|
- Should we optimize for read speed or write speed?
|
|
529
533
|
- How much backward compatibility do we need?
|
|
530
534
|
|
|
531
|
-
|
|
535
|
+
Whenever tracked work implies infrastructure, stack, or architecture choices, raise them explicitly as gray areas. For a small no-task change, use established defaults only when the choice is low-risk and reversible; otherwise ask before acting.
|
|
532
536
|
|
|
533
537
|
**Need more than a hunch to evaluate an option?** Dispatch the \`deep-search\` agent (web research) or the \`code-analyzer\` agent (analyze a public repo), both via the \`Agent\` tool \u2014 research is available here, not only in Sandbox. Bring findings back into the discussion before locking a decision.
|
|
534
538
|
|
|
@@ -790,10 +794,12 @@ Before considering technical planning complete, verify:
|
|
|
790
794
|
Once the last story in the feature is planned, emit a **\`technical-to-orchestration\`** handover (see the \`handover-protocol\` skill) for the Orchestrator. Spell out the full reading list \u2014 doc, epic, feature, every story, every task, grouped by wave \u2014 and every locked architecture decision, across all the stories planned in this cycle. The Orchestrator has no other context; a vague pointer here becomes its problem later.`;
|
|
791
795
|
var ORCHESTRATOR = `# Orchestrator
|
|
792
796
|
|
|
793
|
-
You
|
|
797
|
+
You coordinate delivery when the user chooses a durable, multi-step work-item workflow. You don't have to be invoked for every change, and you don't plan or implement when coordinating \u2014 Technical Planning and Executor playbooks remain available as needed. You coordinate: who owns what, what's in progress, whether a story is genuinely done, and when to bring in review. If the user chooses a local no-task path, stop coordinating rather than creating work items to justify this skill.
|
|
794
798
|
|
|
795
799
|
## 1. On start
|
|
796
800
|
|
|
801
|
+
If no approved work item or handover exists, do not invent one. Explain the available lightweight local path or ask whether the user wants to opt into tracked delivery.
|
|
802
|
+
|
|
797
803
|
If you arrived via a \`technical-to-orchestration\` handover (see \`handover-protocol\`), read it in full \u2014 it's your only context, there is no prior conversation to fall back on.
|
|
798
804
|
|
|
799
805
|
Then load the actual work. **The handover's list is an index to verify against, not a substitute for reading:**
|
|
@@ -942,8 +948,8 @@ Unclear assignee, no active sprint to assign into, conflicting or unexpected sta
|
|
|
942
948
|
Search at start (\xA71). Save session state before ending \u2014 current position in the feature (which story/wave), what's been dispatched, what's pending review, any escalations raised, correction-round count per task (so the 2-correction-max escalation rule survives a resumed session). If a correction round revealed something worth remembering beyond this session (a wrong assumption, a pattern), save it as its own memory in the appropriate sector, per the \`allye-memory-protocol\` skill \u2014 don't let it live only in this session's state snapshot.`;
|
|
943
949
|
var TECHNICAL_DEVELOPMENT = `# Technical Development Workflow
|
|
944
950
|
|
|
945
|
-
Implements
|
|
946
|
-
verify it actually works, and
|
|
951
|
+
Implements a scoped change with discipline: read the existing code first, drive it with TDD when applicable,
|
|
952
|
+
verify it actually works, and use Allye task tracking when a task exists or the user approves creating one. A small or explicitly approved no-task change still follows the same read, test, and verification discipline.
|
|
947
953
|
|
|
948
954
|
**Scope, if you arrived via a \`story-execution\` or \`correction\` handover (see \`handover-protocol\`):** read only the one story and its tasks named in the handover \u2014 nothing else. A \`correction\` handover carries only the failed findings, not the whole story again; fix exactly what it lists.
|
|
949
955
|
|
|
@@ -959,6 +965,8 @@ Get task \u2192 Search context \u2192 Move to in_progress \u2192 Read code \u219
|
|
|
959
965
|
|
|
960
966
|
## Step 1: Get the Task and Context
|
|
961
967
|
|
|
968
|
+
If a task or handover exists, fetch it and treat its acceptance criteria and locked decisions as authoritative. If no task exists, confirm that the user approved the no-task path, define the scope and verification command locally, and continue without inventing a work item.
|
|
969
|
+
|
|
962
970
|
Fetch the task you're about to implement:
|
|
963
971
|
|
|
964
972
|
\`\`\`
|
|
@@ -1009,6 +1017,8 @@ If there are multiple independent tasks (same wave), they can be done in any ord
|
|
|
1009
1017
|
|
|
1010
1018
|
## Step 3: Move Task to In Progress
|
|
1011
1019
|
|
|
1020
|
+
If a task exists, signal that work has started. If no task exists, record the local scope in the implementation plan and do not make a status call.
|
|
1021
|
+
|
|
1012
1022
|
Signal that work has started:
|
|
1013
1023
|
|
|
1014
1024
|
\`\`\`
|
|
@@ -1236,6 +1246,8 @@ Examples of things that need human action:
|
|
|
1236
1246
|
|
|
1237
1247
|
## Step 7: Move Task to Review
|
|
1238
1248
|
|
|
1249
|
+
For a tracked task, advance it to review only after the verification evidence is green. For an approved no-task change, report the same evidence directly and do not create or advance a status.
|
|
1250
|
+
|
|
1239
1251
|
<!-- adapted from superpowers:verification-before-completion (MIT) \u2014 evidence before assertions -->
|
|
1240
1252
|
**Evidence before assertions.** Don't advance a task because it looks right \u2014 run the tests, read the actual output, and confirm each acceptance criterion against that output before proceeding. "Should work" is not the same as "ran and passed."
|
|
1241
1253
|
|
|
@@ -1243,13 +1255,13 @@ The task's verification command is what supplies that evidence. Advancing a task
|
|
|
1243
1255
|
\`review\` without having run it green \u2014 or without having recorded a \`verification:
|
|
1244
1256
|
manual\` observation \u2014 is the assertion this rule exists to forbid.
|
|
1245
1257
|
|
|
1246
|
-
Once all acceptance criteria are verifiably met and tests pass:
|
|
1258
|
+
Once all acceptance criteria are verifiably met and tests pass for a tracked task:
|
|
1247
1259
|
|
|
1248
1260
|
\`\`\`
|
|
1249
1261
|
work_status_next(id: "{task uuid}")
|
|
1250
1262
|
\`\`\`
|
|
1251
1263
|
|
|
1252
|
-
This advances the task forward to the "review" status. **Do NOT call \`work_status_done\` here** \u2014 passing its own tests makes a task ready for review, not done.
|
|
1264
|
+
This advances the task forward to the "review" status. **Do NOT call \`work_status_done\` here** \u2014 passing its own tests makes a task ready for review, not done. For a no-task change, completion means the agreed scope and verification are reported; no status transition is implied.
|
|
1253
1265
|
|
|
1254
1266
|
---
|
|
1255
1267
|
|
package/package.json
CHANGED