Summary
Artefact creation is the culmination of the explore-collect flow. When the user has gathered enough snippets, they trigger an agent-driven process that synthesises those snippets into a structured, polished artefact.
Trigger
- Create Artefact button in the workspace
- Disabled until the system determines there are enough snippets for a detailed output
- When enabled, clicking opens a creation modal
Creation Modal
The modal presents the user with a choice of two artefact types:
Type 1: Report
- A detailed, multi-section document
- Structured with executive summary, sections, analysis, conclusions
- Best suited for in-depth findings, research summaries, compliance reviews, strategic analyses
- Could be multiple pages — as long as the content demands
Type 2: Poster / One-Pager
- A concise 1–2 page document that explains a concept
- Designed to communicate a single idea, finding, or recommendation clearly and quickly
- Think: internal briefing, concept explainer, decision summary
- Visual emphasis — more structured layout, key takeaways, possibly charts/callouts
Modal Contents
- Both types shown side by side with:
- Clear description of what each type is and when to use it
- A skeleton/template preview showing the approximate structure and sections (like a template thumbnail)
- Selection — user picks one type
- Confirmation — kicks off background generation
Background Generation
- An agent processes the collected snippets
- Generates the artefact according to the selected type/template
- This happens asynchronously — the user can continue exploring or leave
- A notification is sent when the artefact is ready (see 07-notifications.md)
Agent Process (To Be Designed)
The artefact generation agent needs to:
- Ingest all workspace snippets with their source context
- Understand the selected artefact type/template
- Synthesise, structure, and write the artefact
- Potentially go back to the source data for additional context
- Produce a draft that the user can review and edit
Open Questions
- Can the user customise the template before generation? (e.g. add/remove sections)
- Is there a "regenerate" option if the user isn't happy with the result?
- Can the user provide additional instructions to the agent? (e.g. "focus on compliance risks", "executive summary style")
- Should there be a preview/draft step before finalising?
- How long does generation typically take? What's the UX during the wait?
- Can multiple artefacts be generated from the same workspace?
UX Refinement Needed
This feature is flagged as needing significant design work to create a great user experience. Key areas:
- The modal flow and template preview design
- The transition from "creating" to "ready" state
- How the user reviews and potentially edits the generated artefact
- The relationship between workspace state and artefact state