How does it handle refactoring?

After tests pass (the 'green' phase), the skill mandates an assessment of refactoring opportunities, ensuring improvements add value and pass all static analysis.

Can this skill be used to maintain existing project docs?

Yes, it specifically includes instructions to keep project documents like CLAUDE.md current when introducing meaningful changes to the codebase.

How does this skill enforce TDD?

The skill establishes a non-negotiable rule that no production code can be written without a preceding failing test, stopping the AI if it attempts to skip the testing phase.

When does the skill suggest documenting a change?

It triggers when you say 'document this' or 'remember this pattern', and automatically after significant features to capture 'what I wish I had known at the start'.

What types of documentation does it help capture?

It provides templates and triggers for capturing gotchas (unexpected behaviors), patterns, anti-patterns, architectural decisions with trade-offs, and edge cases.

Engineering Standards & Documentation

Name: Engineering Standards & Documentation
Author: jscriptcoder

byjscriptcoder

0•

Learning & Documentation

Enforces Test-Driven Development (TDD) principles and captures critical architectural learnings to maintain high code quality and institutional knowledge.

The Expectations skill transforms Claude into a disciplined software engineer by mandating a TDD-first workflow and providing a structured framework for documenting 'gotchas,' patterns, and architectural decisions. It ensures that every code change is backed by failing tests and that valuable developer insights—the 'what I wish I knew' moments—are preserved in a standardized format. By emphasizing first-principles thinking and rigorous documentation triggers, this skill prevents recurring bugs, clarifies complex domain knowledge, and streamlines the onboarding process for future developers.

Key Features

01Standardized documentation format for recording non-obvious edge cases and tool configurations

02Strict TDD enforcement requiring failing tests before any production code is written

03Automatic documentation triggers following the completion of significant features

04Structured framework for capturing 'gotchas', patterns, and architectural trade-offs

050 GitHub stars

06Post-green refactoring assessments to ensure code quality without over-engineering

Use Cases

01Building a searchable repository of project-specific knowledge and architectural rationale

02Streamlining complex refactoring tasks by ensuring full test coverage and context preservation

03Enforcing consistent TDD practices and code quality standards across a development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jscriptcoder/jshack.me expectations

For use in Claude.ai and ChatGPT

Download Skill