crucible-cli 0.1.4

Architecture-first development framework for AI-native applications
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

# Crucible

**Architecture-first development framework for AI-native applications**

Crucible helps teams maintain architectural integrity through formal architecture definitions, automated validation, and seamless Claude Code integration.

## Installation

### Option 1: Using cargo-binstall (Recommended - Fast)

If you have [cargo-binstall](https://github.com/cargo-bins/cargo-binstall) installed:

```bash
cargo binstall crucible-cli
```

This downloads prebuilt binaries from GitHub releases, making installation much faster than compiling from source.

Don't have cargo-binstall? Install it with:
```bash
cargo install cargo-binstall
```

### Option 2: From crates.io (Standard)

```bash
cargo install crucible-cli
```

This compiles from source and may take a few minutes.

### Option 3: From GitHub (Latest Development)

```bash
cargo install --git https://github.com/anvanster/crucible.git crucible-cli
```

This installs the latest unreleased version from the main branch.

### Verify Installation

```bash
crucible --version
```

## Quick Start

```bash
# Create a new project with architecture
crucible init --name my-app

# Validate architecture
crucible validate

# Initialize Claude Code integration
crucible claude init --mode enhanced
```

## Project Structure

- `.crucible/` - Crucible's own architecture definition
- `crucible-core/` - Core library implementation
- `crucible-cli/` - Command-line interface
- `spec/` - Specification documents

## Development

This project uses Crucible to define its own architecture. Before making changes:

1. Update `crucible-core/.crucible/` definitions
2. Validate: `crucible validate --path crucible-core/.crucible --strict`
3. Implement changes
4. Run tests: `cargo test --all`

### Pre-push Checks

Before pushing to main, run all CI checks locally:

```bash
./scripts/pre-push.sh
```

This runs:
- Code formatting check (`cargo fmt`)
- Clippy lints (`cargo clippy`)
- Release build
- Architecture validation
- All tests
- Documentation check

See [scripts/README.md](scripts/README.md) for setup as a Git hook.

## License

Crucible uses dual licensing:

- **Specification** (`spec/`): [CC0 1.0 Universal](spec/LICENSE-SPEC) (Public Domain)
  The Crucible specification, schema, and examples are freely available for anyone to implement.

- **Implementation** (`crucible-core/`, `crucible-cli/`): [Apache License 2.0](LICENSE)
  The Rust implementation code is licensed under Apache 2.0.

See [spec/LICENSING.md](spec/LICENSING.md) for detailed licensing information.