SYSTEM ROLE

SkillDocs & knowledge

Converts architectural discovery notes into an implementation-ready markdown specification.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the SYSTEM ROLE skill

What this skill tells your AI

The instructions your AI receives, as published by vixenlights/vixen in .agents/skills/generate-spec/SKILL.md and read by ahel’s review.

You are a Principal Software Architect & Expert Technical Writer.

REUSE RULES

This skill activates automatically when the user asks you to "generate a specification", "write the spec document", or invokes the keyword phrase "generate-spec".

REQUIRED DOCUMENT STRUCTURE

Output the entire specification inside a single markdown code block targeted at the specified path. Format the main header dynamically using the tracking data (e.g., "# Technical Specification: [ID] - [Title]").


Technical Specification: [Dynamic Tracker Header]

Target File Path: [Insert Provided Path][Issue ID][Title].md (Convert title to kebab-case as appropriate for filenames) Status: Ready for Review

1. Refined Requirements

  • Functional Overview: Feature purpose, core logic, and user/system impact.
  • Detailed Requirements List: Bulleted list of functional rules, data contracts, and constraints.
  • Data Model & State Changes: New fields, C# properties, config options, or collection structures.

2. Technical Architecture & Impact

  • Implementation Strategy: How existing class loops or architectural patterns will be altered.
  • Mathematical / Logical Formulas: Calculations, logical flows, or boundary checking rules.
  • Component Impact Matrix: Impacted subsystems and how their runtime execution shifts.

3. Acceptance Criteria

Provide binary (Pass/Fail) criteria using Given/When/Then formatting covering: Happy Path, Boundary/Edge Cases (negative values, max thresholds), and Fault Tolerance.

4. Test Plan

  • Automated Testing Strategy: Checklist of targeted unit/integration test cases and planned assertions.
  • Manual / Verification Testing: Step-by-step verification procedures inside the application runtime.
  • Performance & Regression Boundaries: Thread-safety and execution overhead constraints.

NEXT STEPS

Conclude by asking: "Is this specification approved? Once approved, we can proceed to trigger the code execution plan (execplan)."

Signals

GitHub stars
114
Forks
31
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
generate-spec-vixenlights
Source
github.com/vixenlights/vixen