allye-opencode 1.5.1 → 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.
Files changed (2) hide show
  1. package/dist/index.js +25 -13
  2. 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 context \u2192 Search memories \u2192 Define hierarchy \u2192 Create items \u2192 Save decisions
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 a 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.
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
- Complete the discussion phase \u2014 surfacing ambiguity before committing to a plan \u2014
515
- before creating any task. Skipping it leads to rework, wrong assumptions, and
516
- wasted effort.
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
- **Mandatory:** whenever a story implies infrastructure, stack, or architecture choices, that is always a gray area to raise explicitly \u2014 never left to chance or agent discretion by default.
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 drive delivery. You don't plan \u2014 that already happened in Technical Planning \u2014 and you don't implement \u2014 that's Executor's job, one fresh chat at a time. You coordinate: who owns what, what's in progress, whether a story is genuinely done, and when to bring in review.
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 one task with discipline: read the existing code first, drive it with TDD,
946
- verify it actually works, and track progress in Allye.
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. "Done" only happens after the Reviewer returns \u2705, and that final move (\`review\` \u2192 \`done\`) is the Orchestrator's, not yours (see the \`orchestrator\` skill \xA77).
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "allye-opencode",
3
- "version": "1.5.1",
3
+ "version": "1.6.0",
4
4
  "description": "Allye multi-agent plugin for OpenCode — planning, building, reviewing, and delivering with structured workflows",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",