doc-bug-auditor

Diagnose Main Sequence project status using repository state, logs, and test outputs.

6|1|Updated Nov 14, 2024
One-click install
npx skills add https://github.com/mainsequence-sdk/mainsequence-sdk --skill doc-bug-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-bug-auditor
Source: https://github.com/mainsequence-sdk/mainsequence-sdk/tree/main/docs/astro/maintenance/bug_auditor
Command: npx skills add https://github.com/mainsequence-sdk/mainsequence-sdk --skill doc-bug-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly determine the health of a Main Sequence project by summarizing completed work, in-progress tasks, and blockers, with evidence-driven conclusions.

Core Features & Use Cases

  • Inspect project state and summarize completion status
  • Read astro/tasks.md and astro/status.md when present
  • Use repository state, logs, and test outputs as evidence to classify failures
  • Produce a structured audit with recommended next actions

Quick Start

Run the audit against a checked-out project directory to generate a concise status report.

Frequently Asked Questions about doc-bug-auditor

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

FAQPage Schema
How do I audit project status and identify blockers from repository logs?

Auditing project status involves reading repository state, logs, and test outputs to classify failures and blockers. The Skill examines astro state files like tasks.md and status.md to generate a structured audit with recommended next actions.

How do I diagnose what is finished, in progress, or failing in a checked-out project?

Diagnosing project completion requires examining repository state, test outputs, and traceback information. The audit classifies tasks across astro components as finished, in progress, blocked, or failing, using evidence from logs and version information.

Can I use test outputs and logs to classify project failures and blockers?

Yes, test outputs, logs, and traceback information are used to classify project failures and blockers. The audit reads this evidence alongside repository state and version information to determine what is blocked or failing and recommend next actions.

What is the best way to summarize completed work and in-progress tasks for a project?

Summarizing completed work and in-progress tasks is done by auditing the project directory using repository state and optional astro state files like tasks.md and status.md. This generates a concise status report with evidence-driven conclusions.

Does the project audit read astro state files to determine completion status?

Yes, the project audit reads optional astro state files such as astro/tasks.md and astro/status.md when present. These files provide evidence to assess completion status and blockers across astro components and tasks.

What should I do when project blockers are not showing up in the status report?

When project blockers are not showing up, ensure the audit examines repository state, logs, and test outputs for traceback and version information. The audit uses this evidence to classify failures and recommend structured next actions.