garura:algorithm

Generate language-agnostic reference pseudocode for complex interfaces in tech.yaml.

3|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kapilvirenahuja/garura --skill garura-algorithm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: garura:algorithm
Source: https://github.com/kapilvirenahuja/garura/tree/main/core/components/plays/algorithm
Command: npx skills add https://github.com/kapilvirenahuja/garura --skill garura-algorithm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns algorithmically complex internal interfaces described in tech.yaml into language-agnostic reference pseudocode, so teams can implement deterministic behavior instead of guessing at tricky flows.

Core Features & Use Cases

  • Detects algorithmic complexity: Scans internal_interfaces behavior_contracts for complexity indicator patterns and also supports an explicit algorithm_spec_required: true trigger.
  • Produces reference pseudocode per interface: Generates reference-algorithms.md with one section per qualifying interface, including complexity classification, pseudocode, invariants, and edge cases.
  • Gates output behind human approval: Writes a DRAFT artifact and requires a user tether action to lock it before evidence is recorded.

Quick Start

Run /algorithm for your issue branch that contains a prepared {stm_base}/{issue}/context/design/tech.yaml describing the complex interfaces you want pseudocode for.

Frequently Asked Questions about garura:algorithm

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

FAQPage Schema
How do I generate reference pseudocode for complex internal interfaces?

You generate reference pseudocode by running the algorithm command on an issue branch containing a prepared tech.yaml file, which produces a language-agnostic reference-algorithms.md artifact. It scans behavior contracts to detect complexity and emits deterministic algorithm documentation.

What is an algorithm spec required trigger in tech.yaml?

An algorithm spec required trigger is an explicit boolean flag set to true in tech.yaml that forces pseudocode generation for specific internal interfaces. It bypasses automated complexity detection by directly signaling that deterministic algorithm documentation is needed.

How do I document edge cases and invariants for complex algorithms?

You document edge cases and invariants by generating a reference-algorithms.md file, which includes a dedicated section per qualifying interface. Each section contains complexity classification, language-agnostic pseudocode, invariants, and edge case handling.

Do I need a human approval gate for generated algorithm documentation?

Yes, a human approval gate is required. The Skill writes a DRAFT reference-algorithms.md artifact that must be explicitly locked via a user tether action before any evidence is recorded in the STM design context.

How does complexity detection work for internal interface behavior contracts?

Complexity detection works by scanning internal_interfaces behavior_contracts in tech.yaml against 11 predefined indicator patterns. If these patterns match or an explicit algorithm_spec_required flag is true, the interface qualifies for pseudocode generation.

Can I use this for enterprise SDLC workflows without guessing algorithm flows?

Yes, it is designed for enterprise SDLC workflows to provide deterministic delivery. It translates algorithmically complex internal interfaces into language-agnostic reference pseudocode, ensuring teams implement exact behavior instead of guessing flows.