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.

name	drafting-artifacts
description	How to create deliverable artifacts (meeting prep briefs, draft emails, analyses) in artifacts/ with required structure and source manifests.