Refresh agent instruction files

This commit is contained in:
2026-05-18 16:55:48 +02:00
parent e24568cb40
commit 2537ca17b8
10 changed files with 368 additions and 115 deletions

View File

@@ -1,65 +1,11 @@
# railiance-apps — Claude Code Instructions
**OAS Stack Level:** S5 Workloads & Experience Endpoints
**Scope:** Application Helm releases and Kubernetes manifests for
user-facing services — Gitea, coulomb services, APIs, web frontends.
**Pre-condition:** The full stack below must be operational:
`railiance-infra``railiance-cluster``railiance-platform``railiance-enablement`
## Custodian State Hub Integration
Domain: **railiance** — topic ID: `ca369340-a64e-442e-98f1-a4fa7dc74a38`
State Hub: http://127.0.0.1:8000
### Session Protocol
**Step 1 — Orient**
```
get_domain_summary("railiance")
```
**Step 2 — Scan workplans**
```
ls workplans/ # read all active workplans; note todo/in_progress tasks
```
**Step 3 — Present brief**
1. Active workstreams for railiance with `[repo:railiance-apps]` tasks
2. Pending tasks from local workplans
3. Goal guidance from summary (needs_workplan / alignment_warnings)
4. Suggested next action
**During work:** use `record_decision()`, `add_progress_event()`, `resolve_decision()`.
**Session close:** `add_progress_event()` with topic_id and workstream_id.
> Design boundary: hub is read model. Bootstrap tools are First Session
> Protocol only. Work originates as files per ADR-001.
### Repo Boundary Rule (ADR-003)
This repo owns **S5 Workloads & Experience Endpoints only**. Do not manage:
- OS-level concerns → `railiance-infra` (S1)
- Kubernetes runtime → `railiance-cluster` (S2)
- Platform services → `railiance-platform` (S3)
- Developer tooling → `railiance-enablement` (S4)
Reference: `railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md`
### Workplan Convention (ADR-001)
File location: `workplans/RAIL-AP-WP-NNNN-<slug>.md`
Prefix: `RAIL-AP`
### SBOM
After updating dependencies:
```bash
cd ~/the-custodian/state-hub
make ingest-sbom REPO=railiance-apps SCAN=1 REPO_PATH=/home/worsch/railiance-apps
```
### Quick Reference
`~/the-custodian/state-hub/mcp_server/TOOLS.md`
@SCOPE.md
@.claude/rules/repo-identity.md
@.claude/rules/session-protocol.md
@.claude/rules/first-session.md
@.claude/rules/workplan-convention.md
@.claude/rules/stack-and-commands.md
@.claude/rules/architecture.md
@.claude/rules/repo-boundary.md
@.claude/rules/agents.md