update-spec

Document executable contracts, validation matrices, and design decisions in code specifications.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/wsmcfr/bisai_f407 --skill update-spec-wsmcfr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-spec
Source: https://github.com/wsmcfr/bisai_f407/tree/main/.agents/skills/update-spec
Command: npx skills add https://github.com/wsmcfr/bisai_f407 --skill update-spec-wsmcfr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps capture and update executable code contracts and design decisions in project specifications after implementation, debugging, or decision-making, ensuring consistent and enforceable standards across cross-layer and infrastructure changes.

Core Features & Use Cases

  • Code-Spec Documentation: Facilitates detailed documentation of signatures, validation matrices, and test points for infra and cross-layer contracts.
  • Decision Recording: Records design choices, patterns, and conventions to promote shared understanding.
  • Use Case: After fixing a critical bug, use this Skill to update the relevant code-spec document to include new error handling protocols and validation rules.

Quick Start

Use the update-spec skill to document the signature validation for the new authentication API implementation.

Frequently Asked Questions about update-spec

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

FAQPage Schema
How do I document executable code contracts after fixing a critical bug?

To document executable code contracts after a bug fix, you record new error handling protocols and validation rules within your project specifications. This ensures updated design decisions and standards are captured and enforced across infrastructure changes.

What is the best way to maintain design decisions and validation matrices in software projects?

Maintaining design decisions and validation matrices involves recording patterns, conventions, and test points in detailed code-spec documents. This practice promotes shared understanding and enforces consistent standards across cross-layer and infrastructure changes.

How do I update project specifications to enforce new validation rules for an authentication API?

Updating project specifications for new validation rules requires documenting the signature validation and test points for the authentication API implementation. This captures the executable contracts needed to enforce the new standards.

When do I need to update code-spec documents for cross-layer contracts?

You need to update code-spec documents for cross-layer contracts after implementation, debugging, or decision-making. This ensures that signature validations, design choices, and infrastructure changes are accurately captured and consistently enforced.

Can I record design patterns and conventions for shared understanding without manual documentation?

Recording design patterns and conventions requires documenting them as executable contracts within project specifications. This process captures specific design choices to promote shared understanding and maintain enforceable standards across the team.

Does capturing executable contracts require external dependencies or frameworks?

Capturing executable contracts does not require external dependencies or frameworks. The process focuses on documenting signatures, validation matrices, and test points directly within your project specifications to enforce standards.