documentation-research
Phase 2 of /shannon:forge. Grounds every external dependency claim in fetched documentation, not training-data recall.
Behavior contract
Produces evidence/documentation-research/<run-id>/ containing:
sources/— raw markdown of each fetched documentation page, named<source>-<ISO-8601-timestamp>.md.SUMMARY.md— citing 3-5 verified facts per source, each linking to the localsources/filename.README.md+INDEX.md.
Methodology
For each external dependency identified by codebase-analysis:
- Prefer
context7MCP for library docs (current, version-aware). - Fall back to
WebFetchagainst the canonical docs URL. - Save the raw markdown to
sources/<lib>-<timestamp>.md. - In
SUMMARY.md, write 3-5 facts with[source: sources/<file>]inline citations.
When to use
- Phase 2 of
/shannon:forge. - Before any SDK / API integration.
- When training data may be stale (recently released libraries, breaking changes in current major).
When NOT to use
- Pure internal-codebase work with no external deps.
- Already-fetched docs < 7 days old (cite the existing source file instead).
Iron rules
- Refuse memory-only references. Every external-fact claim must cite a
sources/file. - ISO-8601 timestamps mandatory. Stale docs are surfaced, not silently used.
- No invented URLs. WebFetch only against URLs the user provided or context7 returned.
Source: krzemienski/shannon — distributed by TomeVault.