From cbc03650d1bc3bc0a114ed89b1a024c84b61a783 Mon Sep 17 00:00:00 2001 From: alexion Date: Fri, 31 Jul 2026 09:55:11 -0400 Subject: [PATCH] feat(research): add durable research skill --- AGENTS.md | 2 ++ skills/research/SKILL.md | 12 ++++++++++++ 2 files changed, 14 insertions(+) create mode 100644 skills/research/SKILL.md diff --git a/AGENTS.md b/AGENTS.md index 6050d1b..df88c52 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,3 +28,5 @@ The domain glossary lives at `$(xdg-user-dir DOCUMENTS)/ai-artifacts/projects/sk Discover context and ADR artifacts through the AI artifacts vault convention rather than assuming fixed names or type directories. - Do not turn opportunistic use of another skill into a declared dependency. Invocation of an unrelated skill remains the agent's discretion unless the current skill directly requires its contract. +- Do not instruct a skill to execute synchronously. + In-process execution is the baseline, while isolation and parallelism belong to an external caller or runtime. diff --git a/skills/research/SKILL.md b/skills/research/SKILL.md new file mode 100644 index 0000000..a5ed832 --- /dev/null +++ b/skills/research/SKILL.md @@ -0,0 +1,12 @@ +--- +name: research +description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the AI artifacts vault. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent. +--- + +Spin up a **background agent** to do the research, so you keep working while it reads. + +Its job: + +1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it. +2. Write the findings to a single Markdown file, citing each claim's source. +3. Save it under `$(xdg-user-dir DOCUMENTS)/ai-artifacts/projects//`, where `` is the lowercase basename of the current working directory. Read the vault's `AGENTS.md` and follow its artifact conventions.