bootstrap-project-rules

Generate engineering rules and implementation contracts after design phase.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/gihwan-dev/claude-setup --skill bootstrap-project-rules
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap-project-rules
Source: https://github.com/gihwan-dev/claude-setup/tree/main/skills/bootstrap-project-rules
Command: npx skills add https://github.com/gihwan-dev/claude-setup --skill bootstrap-project-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the critical post-design, pre-implementation phase by establishing foundational project rules, repository contracts, and implementation guidelines, ensuring a clear and consistent starting point for development.

Core Features & Use Cases

  • Rule Definition: Establishes baseline engineering rules (docs/ai/ENGINEERING_RULES.md) and task-specific implementation contracts (tasks/<task-path>/IMPLEMENTATION_CONTRACT.md).
  • Contract Management: Updates root agent and Claude configuration files (AGENTS.md, CLAUDE.md) and the project README.
  • Decision Framework: Classifies project decisions into 'Locked now', 'Deferred', and 'Banned/Avoid' categories, managing dependencies and architectural choices.
  • Use Case: After a design-task is completed, this Skill can be invoked to solidify the technology stack, define core architectural boundaries, and set up the initial documentation structure before any code is written.

Quick Start

Use the bootstrap-project-rules skill to establish the implementation contract for the 'new-feature' task.

Frequently Asked Questions about bootstrap-project-rules

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

FAQPage Schema
How do I set up engineering rules and implementation contracts before coding?

To set up engineering rules, you establish foundational project contracts by generating `docs/ai/ENGINEERING_RULES.md` and task-specific `IMPLEMENTATION_CONTRACT.md` files, updating root `AGENTS.md` and `CLAUDE.md` configurations to define a clear implementation path.

What is the best way to manage architectural decisions before starting implementation?

Managing architectural decisions involves classifying choices into 'Locked now', 'Deferred', and 'Banned/Avoid' categories. This decision framework manages dependencies and ensures a consistent starting point for development after the design phase.

When do I need to create an implementation contract for my repository?

You need to create an implementation contract during the post-design, pre-implementation phase. It solidifies the technology stack, defines core architectural boundaries, and sets up the initial documentation structure before any code is written.

Can I use bootstrap-project-rules to update AGENTS.md and CLAUDE.md configurations?

Yes, bootstrap-project-rules updates root agent and Claude configuration files (`AGENTS.md`, `CLAUDE.md`) and the project `README.md` with managed sections. This ensures repository contracts are synchronized across your project documentation.

Do I need a completed design phase before establishing project rules?

Yes, you need a completed design phase before establishing project rules. This skill automates the critical post-design phase by taking design outputs and converting them into actionable engineering rules and implementation contracts.

Why classify project decisions into locked, deferred, and banned categories?

Classifying decisions into 'Locked now', 'Deferred', and 'Banned/Avoid' categories prevents scope creep and architectural drift. It manages dependencies by explicitly defining what is finalized, what is postponed, and what approaches to avoid during implementation.