writing-laws

Generate formal codebase laws with hierarchical numbering and mandatory modal verbs.

68|13|Updated Aug 9, 2025
One-click install
npx skills add https://github.com/kriegcloud/beep-effect --skill writing-laws-kriegcloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-laws
Source: https://github.com/kriegcloud/beep-effect/tree/main/.claude/skills/writing-laws
Command: npx skills add https://github.com/kriegcloud/beep-effect --skill writing-laws-kriegcloud

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured and formal method for defining inviolable rules, architectural constraints, and domain-specific standards for codebases, ensuring consistency and adherence.

Core Features & Use Cases

  • Formal Law Creation: Draft laws using precise legal language and hierarchical sectioning (§ I, § I.1.a).
  • Enforceable Standards: Establish mandatory requirements (SHALL, MUST) and prohibitions (SHALL NOT, MUST NOT).
  • Use Case: When establishing critical architectural principles for a new microservice, use this skill to draft laws that dictate communication protocols, data handling, and error management, ensuring all developers adhere to these non-negotiable standards.

Quick Start

Use the writing-laws skill to draft a new law for the codebase that requires all asynchronous actions to be wrapped with Effect.withSpan().

Frequently Asked Questions about writing-laws

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

FAQPage Schema
How do I establish inviolable architectural constraints for a codebase?

Codebase laws formalize inviolable architectural rules using legal-style structure and precise language. They establish mandatory requirements and prohibitions to ensure consistency and adherence across development teams.

How do I formalize codebase standards using legal-style language?

You formalize codebase standards by generating laws with mandatory modal verbs like SHALL and MUST, alongside prohibitions like SHALL NOT. This approach uses hierarchical section numbering and precise legal language to enforce rules.

What is the best way to draft enforceable coding standards for a microservice architecture?

The best way to draft enforceable coding standards is to create formal laws dictating communication protocols, data handling, and error management. Using legal-style structures with severity classifications makes architectural principles non-negotiable.

Can I use hierarchical section numbering when defining domain-specific code rules?

Yes, hierarchical section numbering like § I, § I.1.a is supported when defining domain-specific code rules. The skill includes templates for various law types and document structures like preambles and severity classifications.

How do I classify the severity of codebase violations and architectural rules?

You classify the severity of codebase violations using the included severity classification templates. These templates support various law types and document structures, allowing you to define enforceable requirements and prohibitions with appropriate consequences.