What is the primary documentation format used?

It uses a structured markdown format including context, issue, solution, and code examples for both correct and incorrect approaches.

Does this skill allow writing code before tests?

No, the skill enforces a non-negotiable TDD approach where a failing test must exist before any production code is written.

What kind of documentation does it help capture?

It identifies and documents gotchas, patterns, anti-patterns, architectural decisions, and edge cases to save future developers significant time.

Does it support TypeScript strict mode?

Yes, it specifically requires all code changes to meet TypeScript strict mode requirements as part of its core principles.

How does it handle code refactoring?

It encourages assessing refactoring opportunities after every green test pass, ensuring all tests and static analysis pass before finalizing changes.

Code Quality & Documentation Standards

Name: Code Quality & Documentation Standards
Author: taewook486

bytaewook486

0•

Security & Testing

Enforces strict test-driven development (TDD) principles and structured documentation practices to maintain high-quality, maintainable codebases.

This skill establishes a rigorous framework for software development by mandating a test-first approach where no production code is written without a failing test. It guides Claude to think from first principles, capture critical architectural decisions, and document 'gotchas' or patterns that save time for future developers. By prioritizing context-aware edits and continuous refactoring, it ensures that every code change is intentional, verified, and well-documented within the project's knowledge base, making it ideal for teams focused on long-term maintainability.

Key Features

01Strict Test-Driven Development (TDD) enforcement

02Structured documentation of gotchas, patterns, and anti-patterns

030 GitHub stars

04Automated updates to project documentation like CLAUDE.md

05First-principles architectural reasoning and trade-off analysis

06Context-aware code refactoring and static analysis verification

Use Cases

01Standardizing documentation for team-based repository maintenance

02Enforcing a 'test-first' culture in new or existing software projects

03Capturing tribal knowledge and architectural trade-offs during development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add taewook486/real-estate-mcp expectations

For use in Claude.ai and ChatGPT

Download Skill