Planned
Ferroforge
A Rust project scaffolding tool built around practical, repeatable defaults.
Project overview
Overview
Ferroforge is a Rust project-scaffolding tool and the planned replacement or evolution of the existing scaffold kit.
It focuses on the project shapes and defaults that are used repeatedly rather than trying to become a universal template system.
Rationale
Why Ferroforge exists
Repeated project setup creates small but persistent friction. Ferroforge turns those recurring choices into tested, reproducible templates.
It can eventually integrate with Ferrule so a newly scaffolded project can be initialized and checkpointed through the same visible workflow.
Current target
MVP goal
Ferroforge scaffolds new Rust projects with preferred defaults for Cargo configuration, source layout, documentation, formatting, linting, testing, and optional Git initialization.
Initial templates
Template set
- Rust CLI.
- Rust library.
- Rust workspace.
Generated structure
Preferred defaults
- Cargo.toml.
- src/main.rs or src/lib.rs as appropriate.
- README.md.
- .gitignore.
- rustfmt.toml.
- Clippy and test workflow notes.
Success criteria
Definition of done
- Scaffold a Rust CLI project.
- Scaffold a Rust library project.
- Scaffold a basic workspace.
- Confirm that generated projects build successfully.
- Include the preferred defaults in generated projects.
- Document the available templates.
- Support optional Git initialization.
Boundaries
Non-goals for now
- A large template catalog.
- Web application scaffolding.
- A complex interactive wizard.
- A remote template registry.
- A plugin system.
- Support for every possible project type.
Next action
Next step
Document what the current scaffold kit does, then build the smallest Rust CLI that replaces its most-used path.