SPECIFICATION

Agree on the right change before implementation begins

GenieWorks investigates the request, brings the decisions to your team, and turns the agreed outcome into work an engineer can build and verify.

Follow one request

Email, Slack, or Zendesk → your existing Jira intake → GenieWorks

01 · INVESTIGATE

One click can still create two exports

GenieWorks checks the reported behavior against the code and live evidence before accepting the proposed fix.

Here, Sentry records a lost response. The connected Internal API shows a second job after the retry. Disabling the button would leave that path untouched.

The evidence changes the fix

APP-42 · Evidence brought into the issue
Sentry MCPInternal API MCPProject source
  1. 1
    The first request creates a job

    The response never reaches the browser

  2. 2
    Web retries the export

    A new request identity reaches the API

  3. 3
    The API accepts another job

    The same intent has become two exports

Selected project MCP connections

02 · BOUND THE CHANGE

Follow the whole path. Change only what the fix needs.

A queue redesign would add work without resolving the missing agreement about request identity. This example needs coordinated Web and API changes.

Web

Preserve the request

Keep its identity after a lost response. Give a deliberate new export a fresh identity.

Export API

Reuse the authorized export

Recognize the retry and return the existing job within the caller’s allowed scope.

Export worker

Keep file generation unchanged

The existing worker can process the single accepted job. No worker task is needed for this fix.

Other investigations can use Prometheus, Grafana, Better Stack, or your own internal services through compatible MCP connections selected for the project.

03 · AGREE ON THE BEHAVIOR

Ask the question that changes the product

The code can explain why duplicates happen. It cannot decide what your customer should see when they retry.

GenieWorks raises that choice with its evidence. The answer and QA’s agreement stay with the issue, ready for implementation to use.

APP-42 · Comments & history

  1. GenieWorks AI engineer

    The retry can reuse the job. Should it return the original export or show a duplicate warning?

  2. Alex Developer

    Return the original export. @Sam, does that match the behavior QA expects?

  3. Sam QA lead

    Agreed. Only an explicit New export should create another job. Include denied access in the checks.

  4. GenieWorks AI engineer

    Updated the specification: retry reuse, explicit New export, and permission checks now have separate acceptance criteria.

Team decision carried into the spec

04 · MAKE IT EXECUTABLE

The next engineer inherits the decisions

The specification connects the evidence and agreed behavior to component changes, acceptance criteria, and planned checks. Open the decision and the resulting specification below.

SPECIFICATION REVIEW

“Handle retries” still leaves too much to guess

A separate item-level review finds the vague instruction and makes the required behavior explicit before handoff.

Before review Handle retries safely

After correction Web keeps the original request identity after a lost response. The API returns the existing authorized export. New export creates a fresh identity.

Automatic specification correction enabled in this example. Default review records gaps; correction is optional.

The team reviews and chooses Apply. The test plan describes checks to run; it is not a test result. Applying a specification does not approve code or release a change.

BEYOND THIS BUG

Different requests need different questions

The same shared project context supports a product idea or a supplied design. What changes is the investigation and the agreement the team needs.

A rough product idea

“Let customers schedule exports” leaves frequency, permissions, failure handling, and ownership undecided. GenieWorks works through those decisions and the affected components before turning the idea into scope, acceptance criteria, and a test plan.

A SUPPLIED DESIGN · SEPARATE EXAMPLE

Carry the design into the requirements

An approved export-history drawer should not become a convenient modal. GenieWorks maps the design to your existing UI and specifies what to reuse, adapt, or create.

Placement, action order, selected-row visibility, responsive behavior, and loading, empty, and error states become requirements. Unresolved differences become questions.

Design reference + existing UI → visual requirements

Design handoff · Export history

Approved design Export history
1 All exports Last 7 days
ExportStatus
SeptemberReady
AugustReady
JulyReady

1–3 of 12 · Page 1

2 Export details

September export

3 Retry history

  1. Request received
  2. Retry · same job
  3. Export ready

Download · Close

  1. 1
    Reuse

    Existing table, filters, and pagination. Keep grouping, row density, and column order.

  2. 2
    Adapt

    Existing details drawer. Add retry history; keep right-hand placement and action order.

  3. 3
    Create

    The approved design needs a retry timeline. In this example, no existing pattern fits.

Must stay true Filters above the table · Details in the right-hand drawer · Selected row stays visible

Mobile layout and loading, empty, and error states come from supplied requirements or existing patterns. Unresolved differences stay as questions.

THE APPROACH TRAVELS WITH THE TASK

Your team sets the choices
GenieWorks selects the approach

GenieWorks assesses complexity and selects a specification profile. Your team controls the available models, reasoning depth, instructions, and connected tools. The settings below show those choices.

A clear agreement makes the model handoff possible

In our workflow, GPT-5.6 Sol at high reasoning plans the work; Luna implements against the specification and the same acceptance criteria. GenieWorks recommends an implementation model and reasoning level from the agreement and your configured choices.

Our hands-on estimate: hundreds of developer hours saved on investigation and specification. Experience-based estimate, not a measured customer result.

THE AGREEMENT IS THE STARTING POINT

Now carry it through the code

Follow APP-42 into implementation, where the same criteria expose a missed retry path.

Follow the implementation

Silent visual walkthrough · Narration shown above