draft-reference-algorithms

To generate reference pseudocode from tech.yaml, run the draft-reference-algorithms skill with the interface_ids and tech_yaml_path. It reads behavior_contracts to extract invariants and outputs a reference-algorithms.md file.

Deterministic algorithm reference generation produces language-agnostic pseudocode for complex internal interfaces to reduce implementation ambiguity. It classifies complexity into state-machine, scheduler, retry-backoff, or reconciliation categories to ensure consistent builds.

Yes, you can generate interface pseudocode without modifying tech.yaml. The skill operates with read-only behavior on the tech.yaml file, extracting behavior_contracts to write a separate reference-algorithms.md artifact.

No, generating reference algorithms does not overwrite locked documentation. The skill writes a reference-algorithms.md file with a DRAFT status and explicitly respects LOCKED artifacts to prevent overwriting existing design guidance.

Interface complexity is classified automatically by analyzing behavior_contracts into state-machine, scheduler, retry-backoff, reconciliation, or other categories. This classification drives the extraction of invariants and edge cases for the pseudocode output.

The best way to document algorithmic interface contracts is generating language-agnostic reference pseudocode sections per interface ID. This provides deterministic, implementation-ready guidance that speeds up build and review processes across teams.