sc_skill

Overview

This skill provides the Supernal Coding CLI for developer and project workflow automation. It centralizes task management, requirements tracking, project health checks, testing, git automation, ralph autonomous loops, compliance checks, and documentation workflows. Use it to streamline daily dev operations and enable traceability between specs, tasks, and tests.

How this skill works

The CLI organizes tasks and artifacts in per-repo or global storage and exposes commands for creating, listing, linking, and progressing tasks. It runs health and compliance checks, generates traceability reports, manages specs for autonomous ralph loops, and automates common git/workflow actions. Commands are composed to integrate with agent orchestration, knowledge store maintenance, and CI-style audits.

When to use it

• Manage developer work: create, assign, start, verify, and complete tasks.
• Run project health checks and pre-PR audits before merging changes.
• Track traceability between requirements, features, specs, and tests.
• Execute autonomous workflows using ralph loops and spec files.
• Automate git and workflow actions like smart commits and branch management.

Best practices

• Keep tasks in .supernal/tasks/ per repo or use the global store for cross-repo coordination.
• Run sc health and sc audit before opening pull requests to catch regressions early.
• Use sc spec files to codify expected behavior for ralph loops and automated execution.
• Link tasks to local sessions when using the dashboard for realtime context.
• Schedule knowledge store tidy and reindex regularly (e.g., nightly) to maintain searchable docs.

Example use cases

• Create and assign a feature task, attach a spec, then run sc ralph to autonomously implement iterations.
• Run sc health and sc compliance check on a branch to validate readiness for production.
• Generate a traceability matrix to show coverage from requirements to tests for audits.
• Use sc task next and sc task start in an agent workflow to hand off work between orchestrated actors.
• Automate smart git operations and branch hygiene using sc git smart and sc workflow commands.