LEX AI Artifacts and Handoff
The files LEX AI writes into a downstream project, the consolidated report per mode, and what to include when handing a run over.
LEX AI Artifacts and Handoff
LEX AI creates outputs in downstream projects, not inside the server package. These files are the plan of record, the audit trail, and the handoff memory that lets someone else continue the work.
Primary artifact areas
.lex/contract.mdand.lex/prompt.md: the agreed project contract from Brief mode. The contract is hand-editable, stays tracked in git, and is read back on resume as the user's own words..lex-workflow/: run manifest, step ownership, completed-step state, and resume context. Each mode keeps its own equivalent —.lex-brief/,.lex-reverse/,.lex-edit/,.lex-review/,.lex-test/,.lex-input/,.lex-deploy/,.lex-mvp/.plans/technical_docs/: forward planning outputs and the audit report.plans/business_docs/: backward outputs and the questionnaire-driven business docs.technical-map/: the AST-derived scaffold plus a per-module context file.Tests/,test-runs/,input-changes/,deployment/,reviews/,edits/,mvp/<run_id>/: mode-specific reporting artifacts.
Consolidated reports
Mode | Report |
|---|---|
Edit |
|
Review |
|
Test |
|
Input |
|
Deploy |
|
MVP |
|
The first five sit beside an auto-maintained _index.md. The MVP report has none, because it already lives in its own per-run folder.
Handoff value
- The contract preserves what was agreed, and marks which statements nobody has validated yet.
- Planning docs preserve intent and assumptions.
- The technical map preserves architecture context for future AI sessions.
- Final reports preserve outcomes and open items, including the steps that ended blocked and the gaps a run chose to declare rather than fill.
Practical handoff checklist
- Include the active mode and the run scope.
- Include the key output paths.
- Include unresolved risks and pending follow-up steps.
- Say which artifacts are still uncommitted. Only the forward-style modes commit and push their own output.
See Outputs and artifacts and Handoff.
Was this helpful?
Your feedback shapes what we write next.
