tally

Manage requirements, observation records, and contract clauses for single-feature development tasks.

Updated Oct 15, 2021
One-click install
npx skills add https://github.com/toqoz/config --skill tally-toqoz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tally
Source: https://github.com/toqoz/config/tree/main/home/agents/skills/tally
Command: npx skills add https://github.com/toqoz/config --skill tally-toqoz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of speculative development where code is written based on assumptions rather than observed reality, preventing the creation of features that do not match user intent.

Core Features & Use Cases

  • Evidence-Grounded Workflow: Ensures every requirement is backed by a verifiable observation record, creating a transparent audit trail.
  • Contract-Driven Development: Uses a machine-readable contract to enforce that implementation behavior matches user-defined acceptance criteria.
  • Use Case: When building a new CLI feature, use this skill to define the requirement, perform the implementation, and automatically verify that the output matches the expected behavior through recorded test runs.

Quick Start

Use the tally skill to initialize a new workspace for the feature named user-export-csv and begin the requirement grounding process.

Frequently Asked Questions about tally

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

FAQPage Schema
What is evidence-grounded software development and how does it prevent speculative coding?

Evidence-grounded software development anchors code implementation to verifiable observation records and user-defined acceptance criteria. It prevents speculative coding by enforcing strict provenance, requiring automated subprocess output recording to cross-reference defined acceptance oracles.

How do I enforce contract-driven development for a new CLI feature?

To enforce contract-driven development for a CLI feature, initialize a workspace to define the requirement and machine-readable contract. The workflow automatically verifies implementation behavior by recording subprocess outputs and cross-referencing them against your defined acceptance criteria.

How does contract-driven testing verify implementation behavior matches acceptance criteria?

Contract-driven testing verifies implementation behavior by managing the lifecycle of requirements, observation records, and contract clauses. It automatically records subprocess outputs as verifiable evidence and cross-references them against your defined acceptance oracles to ensure strict compliance.

Can I use automated verification for single-feature development tasks?

Yes, this workflow is designed specifically for single-feature development tasks. It manages the lifecycle of requirements and observation records, enforcing strict provenance by requiring automated recording of subprocess outputs to validate against acceptance oracles.

Do I need pyyaml to manage requirement grounding and observation records?

Yes, pyyaml is required. The workflow uses pyyaml to parse and manage the machine-readable contracts, requirement definitions, and observation records that anchor your single-feature development tasks to verifiable evidence.

What is the best way to create an audit trail for requirement verification?

The best way to create an audit trail for requirement verification is to use a workflow that enforces strict provenance. This requires automatically recording subprocess outputs as observation records and cross-referencing them with defined acceptance oracles.