gr-sw-maker-examples

gr-sw-maker — Nearly Fully Automated Software Development Framework

Japanese Version

A framework that nearly fully automates the software development process using AI coding agent multi-agent capabilities.

What you do: Write a concept → Answer key decisions → Accept the deliverables. That’s it.


Quick Start

See Setup Flow for the full picture.

1. Get it

# From npm (recommended)
npm init gr-sw-maker my-project
cd my-project

# Or from GitHub
git clone https://github.com/GoodRelax/gr-sw-maker.git my-project
cd my-project

2. Choose a language

node setup.js

Select your language from the menu. For other languages, see Language Selection.

3. Choose an AI platform (skip for Claude Code)

If using an AI other than Claude Code, have your AI read the Porting Guide and auto-convert.

See Switching AI Platform for details.

4. Describe what you want to build

Answer three questions in user-order.md:

## What do you want to build?

A web app for managing team tasks — create tasks, assign members, set deadlines,
and view progress on a dashboard.

## Why?

Work is siloed across individuals and no one knows who is doing what.
Excel-based tracking has hit its limits.

## Other preferences

Web-based. Mobile-friendly would be nice.

5. Launch

/full-auto-dev

The AI auto-generates the project configuration (CLAUDE.md), then asks for your review. Once approved, it proceeds through spec writing → design → implementation → testing → delivery automatically.


Development Flow

After launch, the AI progresses through 8 phases automatically:

# Phase What the AI does What you do
1 setup Generate project configuration (CLAUDE.md) Review & approve
2 planning Write specs, conduct structured interviews Answer questions, approve specs
3 dependency-selection Propose external dependencies (HW/AI/frameworks) Approve selections
4 design Architecture design, API design, security design
5 implementation Code implementation, unit tests
6 testing Integration tests, E2E tests, performance tests
7 delivery User manual, IaC deployment Approve IaC, acceptance testing
8 operation Incident response (conditional)

Quality gates (AI reviews) must pass at each phase boundary before proceeding. Issues are auto-fixed by the AI.


AI Platform Support

Default target is Claude Code, but the framework is portable to other AI coding agents.

Status Platform
Ready to use Claude Code
Porting guide available OpenAI Codex CLI, Gemini CLI, Cursor, Windsurf, Cline, Roo Code, Aider

Switching AI Platform

Have your AI read process-rules/porting-guide-en.md and auto-convert.

If your AI can’t handle this conversion, it can’t handle this framework.

If you need both language selection and platform conversion, run language selection → platform conversion in that order.


Language Selection

English / Japanese

Just run the setup script and select from the menu:

node setup.js

Agent definitions and commands are deployed automatically.

Other languages

  1. Have the AI translate:
/translate-framework en fr
  1. Deploy the translated files:
node setup.js fr

Translation rules (what to translate and what to keep in English) are defined in the command.


Documentation

Document Contents
Process Rules Phase definitions, agents, quality gates
Document Rules Naming, block structure, versioning
Agent List All agents, ownership, data flow
Porting Guide Conversion specs for other AI platforms
Glossary Term definitions and rationale
Essays Design rationale for the ANMS / ANPS / ANGS three-tier spec system

Setup Flow

flowchart TD
    Install["1. npm init gr-sw-maker my-project<br/>cd my-project"] -->|"Run"| Setup([node setup.js])
    Setup -->|"lang code<br/>specified?"| ArgCheck{lang code?}
    ArgCheck -->|"Yes<br/>e.g. node setup.js fr"| Deploy[Deploy files]
    ArgCheck -->|"No"| Menu["Select your environment:<br/>1 en Claude<br/>2 ja Claude<br/>3 Other lang Claude<br/>4 en Other AI<br/>5 ja Other AI<br/>6 Other lang Other AI"]
    Menu -->|"1"| Deploy
    Menu -->|"2"| Deploy
    Menu -->|"3"| ClaudeOther["1. /translate-framework<br/>en your-lang<br/>2. node setup.js your-lang"]
    Menu -->|"4"| Deploy4[Deploy files]
    Menu -->|"5"| Deploy5[Deploy files]
    Menu -->|"6"| OtherAIOther["1. AI reads porting-guide<br/>to convert framework<br/>2. AI translates files<br/>see README<br/>3. node setup.js your-lang"]
    Deploy4 -->|"Complete"| PortingMsg4["NOTE:<br/>Have your AI read<br/>porting-guide-en.md<br/>to convert framework"]
    Deploy5 -->|"Complete"| PortingMsg5["NOTE:<br/>Have your AI read<br/>porting-guide-ja.md<br/>to convert framework"]
    Deploy -->|"Complete"| WriteOrder["2. Write your concept<br/>in user-order.md"]
    PortingMsg4 -->|"Next"| WriteOrder
    PortingMsg5 -->|"Next"| WriteOrder
    WriteOrder -->|"Ready"| Launch["3. /full-auto-dev"]
    Launch -->|"Start"| Dev([Development begins])
    ClaudeOther -->|"Re-run"| Setup
    OtherAIOther -->|"Re-run"| Setup

License

© 2026 GoodRelax. MIT License. See LICENSE.