feat: add artifact-backed Wayfinder workflow #19

Merged
alexion merged 6 commits from wayfinder into main 2026-07-31 10:45:12 -04:00
2 changed files with 14 additions and 0 deletions
Showing only changes of commit cbc03650d1 - Show all commits

View File

@@ -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. 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. - 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. 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.

12
skills/research/SKILL.md Normal file
View File

@@ -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/<project>/`, where `<project>` is the lowercase basename of the current working directory. Read the vault's `AGENTS.md` and follow its artifact conventions.