| Initial State | Action |
|---|
Save and load
Import, export, and outputs
Snapshots
Feedback
Current onboarding flow for new analysts
Start here if you are new: use this path to move from intake to reviewed requirements without needing to learn every workspace at once. Follow the steps in order, then use Analysis & AI when you need change triage, deterministic inspection, offline Local AI review, governed proposal help, or code-derived draft extraction for the current slice of work. Finish by checking readiness, generating stakeholder outputs, and opening Governed Handoff before any downstream package leaves ALManac.
1. Start in Cockpit and set your scope
- Open first to see the current hotspots, blockers, and drill-down actions for the requirement set.
- Use it as your orientation screen before you decide whether the next step is intake, modeling, draft review, or cleanup.
Next: register the material you are working from so the requirement trail starts with evidence.
2. Bring in source material
- Open and register the documents, workshop notes, process files, or code artifacts you are working from.
- Keep related source material together here so later review, traceability, and export conversations stay grounded in the same evidence.
Next: build enough business context that requirements can use stable terms, process steps, and journey language.
3. Build the business context
- Use to define roles, business terms, and objects that the requirements should reference consistently.
- Use when the process flow is the clearest starting point for functions, actors, and step order.
- Use when stage and step flow explains the user path better than BPMN.
Optional supporting views: use , , or only when they help explain the current scope. They support the main flow, but they do not need to come first.
Next: create the first useful requirement set in the workspace that matches your starting material.
4. Create or refine requirements
- Use to create, edit, and organize EPICs, HLRs, User Stories, and Acceptance Criteria directly.
- Use when you are starting from source text and want to draft structured candidates from that material before promotion.
- If you need AI-supported work, use AI Workbench for governed proposal packets, validation, and draft-only staging; use Local AI or Refinement local LLM review only after the source and scope are clear so advisory local model output stays bounded.
- If your starting point is process or journey modeling, generate drafts from or , then keep the requirement wording aligned with the source and glossary language.
Next: review generated drafts before they become part of the canonical requirement tree.
5. Review draft candidates and promote what is worth keeping
- Open when BPMN, Journey, Parser, or other flows have produced drafts that still need analyst review.
- Promote only the drafts that are clear enough to join the main hierarchy, and leave rejected or weak candidates out of the canonical set.
Next: clean up structure, coverage, and wording until the requirement set reads as a coherent whole.
6. Clean up and review the requirement set
- Use to find duplicates, wording issues, weak structure, and other analyst cleanup work.
- Use to inspect coverage across processes, journeys, intents, and linked artifacts.
- Use when an incoming change needs read-only impact triage before you edit, refine, or promote requirements.
- Use when you have a question and need deterministic Q&A, search, or explanation over requirements and traceability.
- Use when you want governed AI context packets, strict proposal validation, Reality Extraction, or draft-only staging.
- Use when you want Ollama/local LLM review over normalized outbound packets with advisory human-readable results; it does not persist chat history, mutate canonical requirements, or change traceability.
- Use when you want proposal-based rewrite, intent alignment, process-mapping help, or Run with Local LLM staged review without changing canonical requirements automatically.
Finally: confirm readiness, generate stakeholder-facing outputs, then preview the governed handoff before downstream export.
7. Finalize requirements and prepare Governed Handoff
- Return to or to confirm the set is ready enough for business review.
- Use to generate stakeholder-facing HTML, Word, Obsidian, or governed Narrative Export bundles for NotebookLM from the reviewed requirement set.
- For ARIS delivery, open , set Work profile = ARIS delivery, keep the current filtered List scope, and follow Export / baseline readiness as one governed handoff preparation path.
- Open to inspect purpose, audience, authority / trust, readiness, included and excluded scope, transformation risk, and the next action for the selected outbound package.
- Only after Governed Handoff shows the selected package is understood and unblocked, run the downstream export or external handoff action.
Learn more: Public ALManac documentation