| name | drafting-artifacts |
| description | How to create deliverable artifacts (meeting prep briefs, draft emails, analyses) in artifacts/ with required structure and source manifests. |
Drafting artifacts
Artifacts are deliverables the agent produces for humans: meeting prep briefs, draft client emails, analyses, summaries. They live in artifacts/ and must be self-contained and auditable.
File naming
artifacts/<YYYY-MM-DD>-<slug>.md (date = today). Example: artifacts/2026-06-10-annual-review-prep.md.
Required structure
Every artifact must contain, in order:
---
type: <brief | draft-email | analysis | summary>
created: <ISO timestamp>
task: <one-line restatement of the request>
sources:
- <relative-path>
- <relative-path>
---
# <Title>
<body>
## Open questions
<Bulleted list of unresolved items a human should address, or "None.">
- The frontmatter
sources list must name every file the artifact relies on.
- In the body, cite specific claims inline using
[source: <path>:<line>], same as the answering-with-citations skill.
Artifact-type guidance
Meeting prep brief
Sections: Client snapshot, What changed since last meeting, Commitments we made, Commitments they made, Agenda recommendations, Open questions. Lead with what the advisor must not forget.
Draft client email
Match the client's preferred tone and channel if known from the workspace. Keep it under 250 words. Include a [DRAFT - requires advisor review] marker at the top of the email body. Never invent commitments or numbers.
Analysis
State the question, the data used, the method, the finding, and the limitations. Show figures with their source citations.
Rules
- Never modify source files; artifacts are new files only.
- Re-verify every number against a primary source before including it.
- If required information is missing, write the artifact anyway, mark gaps as
[MISSING: <what>], and list them under Open questions.