context-audit

Audit team knowledge gaps and generate onboarding plans for engineering teams.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill context-audit-serpro-workshop-fortaleza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-audit
Source: https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula/tree/main/.github/skills/context-audit
Command: npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill context-audit-serpro-workshop-fortaleza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams often carry hidden knowledge gaps: critical modules understood by only one person (bus factor of 1), undocumented architectural decisions, and onboarding that consists of just reading READMEs. This Skill measures shared team understanding, exposes concentrated knowledge risk, and produces a concrete first-week onboarding plan for new engineers. ## Core Features & Use Cases - Structured Audit Interviews: Five targeted questions asked privately to each team member to reveal divergent mental models of architecture, invariants, and risky code. - Risk Heatmap Generation: Produces a module-by-module table of criticality, bus factor, last refactor date, and owner, flagging any high-criticality module with bus factor 1 as a P0 action. - First-Week Onboarding Playbook: Generates a day-by-day operational guide (ADRs to read, pairing sessions, on-call shadowing, first low-risk change) so new hires ship a reviewed change by end of week one. - Use Case: A new developer starts Monday and the billing module is understood only by one senior engineer. Run the audit to map shared architecture understanding, identify the bus-factor risk, and produce a pairing-based onboarding plan that transfers knowledge. ## Quick Start Ask the AI to run a context audit on your team to identify knowledge gaps and create a first-week onboarding plan for a new engineer.

Frequently Asked Questions about context-audit

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

FAQPage Schema
How do I audit my engineering team's shared knowledge?

Run a context audit by asking each team member privately five questions about architecture, invariants, risky code, and areas they avoid changing. Divergent answers reveal knowledge gaps that need documentation or pairing.

How do I create a first-week onboarding plan for a new developer?

Structure the week around action: day one reading key ADRs and running services locally, day two pairing on the riskiest module, day three shadowing on-call, day four a small reviewed change, day five a retrospective with the tech lead.

What is a bus factor risk heatmap for code modules?

A risk heatmap is a table listing each module with its criticality, bus factor, last refactor date, and owner. Any high-criticality module with a bus factor of 1 requires an immediate P0 remediation action such as pairing or documentation.

Why is README-only onboarding insufficient for new engineers?

READMEs omit tacit knowledge like system invariants, failure modes, and which code is risky to touch. Effective onboarding requires hands-on tasks: running the system, pairing with module owners, and shipping a reviewed change in week one.

When should a team run a context audit?

Run one when a new engineer joins, when integrating into an unfamiliar codebase, or when knowledge is concentrated in one person for a critical module. Trigger phrases include onboarding, knowledge gap, bus factor, and team understanding.