Skip to content
why did we choose this

Engineering planning & review

Engineering decisions.
Shared context.

Bring plans, team discussions, and pull request reviews into one place. Preserve what you agreed to build—and why.

Search architecture in the rocky.systems workspace, with the published plan alongside the team's discussion.

Collaborative planningTurn discussions into structured plans.

Versioned agreementsCapture what you agreed to build.

GitHub reviewConnect code review to the plan.

From plan to pull request

Review against
the agreement.

Find consequential departures with citations to the plan and evidence from the code. Your team decides how to resolve them.

  • Exact plan citations

    See precisely which part of the agreement is relevant.

  • Version-specific findings

    Review against the version your team agreed to.

  • Human-led resolution

    Keep engineers in control of how to handle findings.

PR #42 · Add semantic search

Conflicts with plan
Reviewed against Search architecture · v1
PR revision 8f3c2a1

Plan conflict

This change sends incident content to an external service, which conflicts with the agreed data handling policy.

Cited from plan

“Incident text must remain inside company-managed infrastructure.”Search architecture · v1 · Data handling

Code evidence src/search.ts · line 12

12 const embedding = await externalClient.embed(incident.text);
13 const results = await index.query(embedding);
14 return results;
Advisory review · your team chooses the resolution

A clear path from discussion to delivery.

  1. Plan together

    Capture problems, goals, and options in a shared document. Invite the right people to the discussion.

  2. Agree on a version

    Publish a clear, versioned record of the decision that your team can reference during implementation.

  3. Keep reviews grounded

    Connect pull request findings to exact plan citations and evidence from the code.

The workspace decision library, showing published and draft plans for incident search, developer platform, and workspace security.

Build with shared context.

Start a plan