grimoire-audit

Audit codebases to identify undocumented features and architecture decisions.

Updated Jan 26, 2025
One-click install
npx skills add https://github.com/jlissner/lissner.io --skill grimoire-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grimoire-audit
Source: https://github.com/jlissner/lissner.io/tree/main/.claude/skills/grimoire-audit
Command: npx skills add https://github.com/jlissner/lissner.io --skill grimoire-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit an existing codebase to discover undocumented features and architecture decisions, helping onboard teams and capture critical knowledge.

Core Features & Use Cases

  • Guided, interview-based scope definition for features and architectural decisions
  • Discovery of undocumented behavior and ADR gaps across the repository
  • Drafts targeted artifacts (grimoire changes) and summaries after user confirmation
  • Batch findings presented in manageable prompts to facilitate collaborative decision making

Quick Start

Interview the user to begin an audit, then gather scope, discovery targets, and draft artifact outlines in a single pass

Frequently Asked Questions about grimoire-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit an existing codebase for undocumented architecture decisions?

To audit a codebase for undocumented architecture decisions, use a structured workflow to map features, identify ADR gaps, and propose grimoire artifacts that capture critical knowledge for team onboarding.

What is a grimoire artifact in codebase documentation?

A grimoire artifact in codebase documentation is a proposed record that captures undocumented features and architecture decisions discovered during an audit, guiding collaborative decision-making and knowledge onboarding.

How do I find undocumented features and ADR gaps in my repository?

You can find undocumented features and ADR gaps by applying a structured audit workflow that maps existing features, discovers undocumented behavior across the repository, and presents batch findings for collaborative review.

Can I use an interview-based scope definition for codebase audits?

Yes, you can use a guided interview-based scope definition to begin a codebase audit, which helps gather discovery targets and draft artifact outlines in a single pass to ensure accurate onboarding documentation.

What's the best way to onboard teams using undocumented architecture decisions?

The best way to onboard teams using undocumented architecture decisions is to audit the codebase, map feature and decision gaps, and draft targeted grimoire artifacts that present batch findings for collaborative decision-making.

Does the codebase audit workflow support batch findings for collaborative review?

Yes, the codebase audit workflow supports batch findings by presenting manageable prompts that facilitate collaborative decision-making before drafting targeted grimoire artifacts and summaries after user confirmation.