Go to file

tegwick 1aa5e436ae fix(CLAUDE.md): rewrite session protocol to surface custodian tasks on open

Previous CLAUDE.md only had a First Session Protocol. When workstreams already
existed, the session would call get_state_summary() and produce no useful output.

New 3-step protocol:
- Step 1: get_state_summary() + get_next_steps() via state-hub MCP tools
- Step 2: scan workplans/*.md for active tasks
- Step 3: output orientation brief: active workstreams, pending repo tasks
  (from workplans/ + [repo:railiance-bootstrap] state hub tasks), suggested
  next action, SBOM status (currently null — gap noted)

Also adds Known Pending Tasks table for RAIL-BS-WP-0001 (dep management)
and strengthens ADR-001 workplan convention and contribution tracking sections.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-01 20:05:22 +01:00

.github/workflows

railiance: initial bootstrap scaffold

2025-09-12 01:46:14 +02:00

ansible

feat: rails style bootkit bin/railiance with quickstart

2025-09-13 01:32:19 +02:00

bin

feat: backup + preflight commands, decisions log, gitignore update

2026-02-25 23:59:28 +01:00

cloudinit

feat: rails style bootkit bin/railiance with quickstart

2025-09-13 01:32:19 +02:00

docs

fix: correct pg_stat_user_tables column name in restore drill (relname not tablename)

2026-02-26 07:25:59 +01:00

lib

refactor: separated command script

2025-09-13 02:39:47 +02:00

tests

railiance: initial bootstrap scaffold

2025-09-12 01:46:14 +02:00

tools

feat: backup + preflight commands, decisions log, gitignore update

2026-02-25 23:59:28 +01:00

wiki

docs: add ThreePhoenix architecture concept and workplan

2026-02-25 01:13:05 +01:00

workplans

feat(sbom): add workplan RAIL-BS-WP-0001 — fix Ansible dep management

2026-03-01 19:29:20 +01:00

.editorconfig

chore: optimize .editorconfig for consistent coding style

2025-09-12 02:19:01 +02:00

.gitattributes

chore: .gitattributes updated for line ending normalization

2025-09-12 02:21:05 +02:00

.gitignore

feat: backup + preflight commands, decisions log, gitignore update

2026-02-25 23:59:28 +01:00

CLAUDE.md

fix(CLAUDE.md): rewrite session protocol to surface custodian tasks on open

2026-03-01 20:05:22 +01:00

DECISIONS.md

feat: backup + preflight commands, decisions log, gitignore update

2026-02-25 23:59:28 +01:00

LICENSE

chore: add MIT License

2025-09-12 02:44:03 +02:00

QUICKSTART.md

chore: another improvement

2025-09-13 01:23:02 +00:00

README.md

chore: add MIT License

2025-09-12 02:44:03 +02:00

README.md

Railiance Bootstrap

Opinionated Infrastructure-as-Code framework for reproducible, self-reliant systems.

Railiance is an opinionated Infrastructure-as-Code framework —
think Rails for Ops: convention over configuration, reproducibility first.

This repo (railiance-bootstrap) is the entry point:
from two bare Linux servers, a Git repo, and credentials, you can rebuild
a fully automated Kubernetes-based environment.

🚀 Quick Start

Clone this repo

git clone <your-gitea-url>/railiance-bootstrap.git
cd railiance-bootstrap

Configure Gitea access
Edit ~/.railiance_gitea.conf with your server URL, username, and token.
(Never commit this file!)
Bootstrap a host
Run the Ansible playbooks in ansible/ to set up k3s, Helm, kubectl.
Deploy baseline services
Use helm/ charts to roll out essential services (GitOps, monitoring, etc.).
Validate
Check the automated tests in tests/ to confirm infra health.

📂 Repo Structure

ansible/ — Playbooks for provisioning
helm/ — Opinionated Helm charts
k8s/ — Kubernetes manifests
tests/ — Automated validation
docs/ — Documentation (see docs/README.md)
tools/ — Helper scripts (e.g. create_railiance_repo.sh)

🤝 Contributing

See docs/CONTRIBUTING.md.

🌍 Vision

Railiance aims for self-reliant infrastructure:
automation you can rebuild from scratch, with calmness and clarity.

From bare metal to resilient clusters — in one repo.