https://github.com/homestak-dev/homestak-dev
Parent repository for homestak-dev polyrepo workspace
https://github.com/homestak-dev/homestak-dev
homelab infrastructure-as-code polyrepo proxmox
Last synced: 4 months ago
JSON representation
Parent repository for homestak-dev polyrepo workspace
- Host: GitHub
- URL: https://github.com/homestak-dev/homestak-dev
- Owner: homestak-dev
- License: apache-2.0
- Created: 2026-01-09T13:14:06.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2026-03-03T01:36:11.000Z (4 months ago)
- Last Synced: 2026-03-03T05:35:30.218Z (4 months ago)
- Topics: homelab, infrastructure-as-code, polyrepo, proxmox
- Language: Shell
- Size: 804 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# homestak-dev
Polyrepo workspace for homestak infrastructure-as-code.
For end-user documentation, see the [organization profile](https://github.com/homestak-dev).
## Quick Start (Contributors)
```bash
# Clone the parent repo
git clone https://github.com/homestak-dev/homestak-dev.git
cd homestak-dev
# Full workspace setup
make setup
```
This clones all child repos, registers them with gita, checks dependencies, and configures git hooks for secrets management.
If dependencies are missing, you'll see:
```
Checking dependencies...
gita: OK
packer: MISSING
shellcheck: MISSING
...
Missing dependencies: packer shellcheck
Run: sudo make install-deps-all
```
Install missing dependencies and verify:
```bash
sudo make install-deps-all
gita ll
```
## Project Structure
```
homestak-dev/ # This repo (workspace parent)
├── .claude/ # Claude Code configuration and skills
├── .github/ # GitHub org config (PR templates, CI)
├── ansible/ # Playbooks for host configuration
├── bootstrap/ # Entry point - curl|bash installer
├── iac-driver/ # Orchestration engine
├── packer/ # Image templates
├── site-config/ # Secrets and configuration
└── tofu/ # VM provisioning modules
```
## Workspace Management
This workspace uses [gita](https://github.com/nosarthur/gita) to manage multiple repos.
### Makefile Targets
| Target | Description |
|--------|-------------|
| `make setup` | Full workspace setup (clone, register, check deps, configure hooks) |
| `make check-deps` | Check if all dependencies are installed |
| `make install-deps-all` | Install dependencies across all repos (requires sudo) |
### Gita Commands
| Command | Description |
|---------|-------------|
| `gita ll` | Status of all repos |
| `gita fetch` | Fetch all repos |
| `gita pull` | Pull all repos |
| `gita shell ` | Run command in all repos |
## Documentation
| File | Purpose |
|------|---------|
| [CLAUDE.md](CLAUDE.md) | Architecture, conventions, development guide |
| [docs/lifecycle/](docs/lifecycle/) | 7-phase development lifecycle |
| [docs/REPO-SETTINGS.md](docs/REPO-SETTINGS.md) | Repository configuration standards |
| [docs/CLAUDE-GUIDELINES.md](docs/CLAUDE-GUIDELINES.md) | Documentation standards |
| [docs/ISSUE-GUIDELINES.md](docs/ISSUE-GUIDELINES.md) | Issue creation and labeling standards |
## Claude Code Skills
| Skill | Subcommands | Description |
|-------|-------------|-------------|
| `/sprint` | plan, init, validate, sync, merge, close | Sprint lifecycle management |
| `/release` | plan init, plan update, execute | Release lifecycle with gates |
| `/session` | save, resume, checkpoint | Context preservation across compactions |
| `/issues` | - | Gather GitHub issues across all repos |
See [.claude/CLAUDE.md](.claude/CLAUDE.md) for complete skill documentation.
## License
Apache 2.0