BigBang — Pre-Project Rules Initializer

Agent-agnostic skill that generates AGENTS.md with 23 maintainability rules before starting any project. Works with opencode, Gemini, Cline, Cursor, Copilot, and any AI agent that reads AGENTS.md.

Features

• Configurable presets — strict (enterprise), prototype (fast/loose), library (public package), or fully custom
• Language-aware — Python gets PEP 8 + mypy, Go gets gofmt, Rust gets clippy, JS/TS gets ESLint + strict TypeScript
• 23 rules — SOLID, YAGNI, design patterns, naming, testing, security, error handling, performance, deps, git, API design, database, logging, Docker, type safety, code review, and more
• Version-stamped — generated AGENTS.md includes a BigBang version and date
• Before/after examples — concrete snippets per rule
• Agent-agnostic — generates AGENTS.md + agent-specific files (.cursorrules, .clinerules, etc.)

Rules

| # | Rule | strict | prototype | library | |---|------|--------|-----------|---------| | 1–9 | Architecture + Style | ✓ | ✓ | ✓ | | 10 | Conventional Commits | ✓ | ✗ | ✓ | | 11 | Testing (≥90% cov) | ✓ | ✗ | ✓ | | 12–16 | Security + Process | ✓ | ✓ | ✓ | | 17 | Changelog + SemVer | ✓ | ✗ | ✓ | | 18 | API Design | ✓ | ✗ | ✓ | | 19 | Database | ✓ | ✗ | ✗ | | 20 | Logging | ✓ | ✗ | ✗ | | 21 | Docker | ✓ | ✗ | ✗ | | 22 | Type Safety | ✓ | ✓ | ✓ | | 23 | Code Review | ✓ | ✗ | ✓ |

Also generates: linter config, CHANGELOG.md, bigbang.config.json, Dockerfile, CI workflow, .env.example, and more.

Installation

npm install bigbang-skills

Or clone the repo and copy to your skills directory:

git clone https://github.com/luckyman147/BigBang.git
cp -r BigBang ~/.claude/skills/bigbang

Usage

When you start a new project, simply say:

• "create a project"
• "start a new project"
• "setup rules"
• "initialize rules"

Then choose a preset (strict/prototype/library) or customize each rule. The agent generates AGENTS.md + config files matching your stack.

Presets

| Preset | File limit | Coverage | Docker/DB rules | Best for | |--------|-----------|----------|-----------------|----------| | strict | 150 lines | 90% | ✓ | Enterprise, production services | | prototype | 300 lines | off | ✗ | MVPs, hackathons, experiments | | library | 200 lines | 90% | ✗ | npm/PyPI/crates.io packages |

Customizing

Copy configs/bigbang.config.json to your project root and toggle any rule:

{
  "rules": {
    "file-size-limit": {
      "enabled": true,
      "maxLines": 200
    }
  }
}

Topics

ai-agents agent-skills coding-standards agents-md developer-tools project-initializer solid-principles yagni clean-code opencode cursor cline copilot

Author

luckyman147 — GitHub