Metadata-Version: 2.4
Name: firstcut
Version: 0.1.0
Summary: First-principles project scaffolder with embedded AI skills
Project-URL: Homepage, https://github.com/shailvshah/firstcut
Project-URL: Repository, https://github.com/shailvshah/firstcut
Project-URL: Issues, https://github.com/shailvshah/firstcut/issues
Author-email: Shail Shah <shailvshah@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ai-tools,claude,clean-architecture,codex,project-generator,scaffolding
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: black>=24.4; extra == 'dev'
Requires-Dist: detect-secrets>=1.4; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pre-commit>=3.7; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Requires-Dist: twine>=6.0; extra == 'dev'
Description-Content-Type: text/markdown

# firstcut

`firstcut` is a first-principles project scaffolder for teams that want more than a folder template.

Run one command, answer four prompts, and get a project with:

- layered architecture for backend, frontend, monorepo, tooling, infrastructure, or docs projects
- AI context files for Claude Code, Codex, Cursor, and Windsurf
- embedded AI skills for domain modeling, TDD, interface design, implementation simplicity, and QA
- pre-commit hooks, CI templates, domain docs, and a 95% coverage culture baked in

## Install

```bash
uv tool install firstcut
# or
pipx install firstcut
```

## Use

```bash
firstcut init
firstcut init --defaults
firstcut init --defaults --project-name billing-api --output-dir ./scratch
firstcut init --defaults --config ./firstcut.toml
```

Interactive prompts can be cancelled with `cancel`, `exit`, `quit`, or `q`.

## Example config

```toml
project_type = "backend"
language = "python"
framework = "fastapi"
pkg_manager = "uv"
project_name = "billing-api"
ci = ["github-actions"]
skills = ["tdd", "qa", "implementation-simplicity"]
```

## Project status

firstcut is alpha software. The Python CLI is the canonical runtime; npm and Go launcher wrappers live in the source repository for cross-ecosystem distribution.

See the full README and source at: https://github.com/shailvshah/firstcut
