Story 4
Technical Review
As a tech lead, I want a quick summary of project state and risky areas before reviewing changes.
"Inspect this repo, summarize the current state, and show me risky areas."
- Checks repo contents and status
- Highlights high-risk files or changes
- Exposes runtime steps and events
- Requires approval for any mutating actions
Outcome: Technical review starts with a reliable operational snapshot.
Story 5
Consultancy Discovery
As a consultant, I want to map a client project quickly and identify the important integration points.
"Map the project, explain the architecture clues, and highlight integration points."
- Scans workspace structure
- Identifies frameworks and languages
- Uses semantic search for concepts
- Stores findings as reusable context
Outcome: Discovery work becomes faster and more repeatable.
Story 6
Repeatable Workflows
As an engineering team, we want to convert repeated routines into reusable workflows.
"Run the refactor workflow."
- Loads a predefined workflow
- Executes ordered steps with context passing
- Records execution history
- Lets users inspect, retry, or approve steps
Outcome: Operational routines become reusable AI-native workflows.
Story 7
Multi-Agent Coordination
As a user, I want specialized agents to collaborate on a task without manually orchestrating them.
"Have one agent inspect the repo, another analyze diagnostics, and a third summarize the likely fix path."
- Assigns specialized roles and delegates work
- Shows handoffs and message flow
- Preserves approvals and event trace
- Presents a combined result
Outcome: Complex analysis becomes coordinated and inspectable.
Story 8
Safe Governed Automation
As a stakeholder, I want to see AI execution without giving the system uncontrolled power.
"Run a gated command in this sandbox."
- Shows the plan before action
- Pauses for approval on gated steps
- Exposes timeline, metrics, and events
- Allows approve / deny / retry / explain
Outcome: The system demonstrates trust, governance, and runtime transparency.
Story 9
Desktop Technical Companion
As a developer on my machine, I want a local desktop app that gives me a persistent AI shell for project work.
"Open my current workspace and help me continue the last task."
- Launches as a desktop shell and restores context
- Exposes workspace views and runtime state
- Supports local-first operation with no cloud dependency
Outcome: Machina feels like an always-available technical operating layer, not a disposable browser assistant.