draft-reference-algorithms

What problem does it solve?

Complex internal interfaces often lack clear, language-agnostic algorithm guidance, making implementations inconsistent, hard to validate, and difficult to maintain across teams.

Core Features & Use Cases

• Language-agnostic reference pseudocode: Produces one documented algorithm section per qualifying internal interface ID to reduce ambiguity during implementation.
• Deterministic artifact generation: Writes a single output file reference-algorithms.md with a DRAFT status and respects LOCKED artifacts to avoid overwriting.
• Complexity-aware guidance: Classifies interfaces into complexity classes (state-machine, scheduler, retry-backoff, reconciliation, other) and extracts invariants and edge cases from behavior_contracts.
• Use Case: When you have an AI-native SDLC design step and a tech.yaml describing internal interfaces, this skill generates consistent reference algorithm sections to speed up build and review.

Quick Start

Ask the system to run draft-reference-algorithms with interface_ids and the tech_yaml_path pointing to the relevant issue design/tech.yaml to generate reference-algorithms.md.