skunexus-backend-summary

Generates and drift-checks per-ticket backend summary documents grounded in branch code.

Updated Jul 14, 2026
One-click install
npx skills add https://github.com/SkuNexus-Devs/skunexus-ai --skill skunexus-backend-summary-skunexus-devs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skunexus-backend-summary
Source: https://github.com/SkuNexus-Devs/skunexus-ai/tree/main/skills/skunexus-backend-summary
Command: npx skills add https://github.com/SkuNexus-Devs/skunexus-ai --skill skunexus-backend-summary-skunexus-devs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After finishing backend work on a ticket, there is no durable record of what was implemented and why — the knowledge lives only in the diff and the developer's memory. This Skill produces .ai/<TICKET>/backend-summary.md, a current-state feature document grounded in the real code, and later re-verifies that the document still matches the code after changes. ## Core Features & Use Cases - Summary generation: Reads the ticket branch diff against the base branch, recovers the why from prd.md, decisions.md, and investigation.md, interviews the developer for gaps, and writes a fixed-template summary covering behavior, data model, backend map, decisions, and pending work. - Drift-check mode: On reruns, diffs from the recorded scan baseline, presents discrepancies before editing, updates only facts the code contradicts, and flips status back to Draft for re-approval. - Review gate: The document ships only on explicit developer approval, with Status tracked from Draft to Approved. - Use Case: Before opening a PR for PHG-418, ask for the backend summary; the Skill scopes the diff against dev, reads the touched handlers and migrations, and produces a document your teammates and future documentation efforts can rely on. ## Quick Start Ask the assistant to write the backend summary for the current ticket branch before creating the PR.

Frequently Asked Questions about skunexus-backend-summary

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

FAQPage Schema
How do I document what a backend ticket implemented?

Run the backend summary skill on the ticket branch. It scopes the work via the diff against the base branch, reads the touched code in full, recovers intent from pipeline artifacts, and writes `.ai/<TICKET>/backend-summary.md` following a fixed template.

How do I verify existing documentation still matches the code?

Rerun the skill when a `backend-summary.md` already exists. It enters drift-check mode, diffs from the recorded scan baseline, presents discrepancies first, and updates only facts the code contradicts without rewriting accurate prose.

Does the backend summary cover frontend changes?

No. The summary is backend only: domain logic, commands, handlers, endpoints, GraphQL types, database, jobs, config, and permissions. Frontend-facing details belong in the separate `fe-handoff.md` document.

What happens when the reason behind a decision is not in any artifact?

The skill interviews the developer with focused questions rather than guessing. The document does not ship with an invented rationale, because these summaries later feed aggregated feature documentation.

When should I not use the backend summary skill?

Do not use it for PR descriptions, frontend handoff notes, bug investigation, or general how-does-X-work questions. Those belong to the backend-pr, fe-handoff, bug-hunt, and docs-c7 skills respectively.