Document Universe CI/CD workflow

[kalinco-glitch]

Summary

• add docs/cicd.md documenting the current Universe branch CI/CD stages, image build/test flow, deployment handoff, and rollback approach
• add docs/dev-workflow.md documenting the day-to-day universe branch PR flow, CI expectations, and deployment status checks
• clarify that the current repository-owned workflow stops at GHCR image build/test handoff and does not yet include a direct universe.bawes.net SSH deploy job

Verification

• git diff --check

Part of #10.

Summary by CodeRabbit

Release Notes

• Documentation
  • Added comprehensive CI/CD pipeline documentation covering workflow triggers, image build process, testing procedures, and deployment workflows.
  • Added development workflow guidelines documenting branching conventions, pull request expectations, CI requirements, and rollback procedures.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c3c6c15e-8e64-4152-9897-899e0f6ffab6

📥 Commits

Reviewing files that changed from the base of the PR and between e3106e7 and e3ec90b.

📒 Files selected for processing (2)

• docs/cicd.md
• docs/dev-workflow.md

---

📝 Walkthrough

Walkthrough

This PR introduces two complementary documentation files for the universe branch. docs/cicd.md documents the CI/CD pipeline architecture, including workflow triggers, image building with GHCR, test stages with Playwright, and deployment via external tooling with rollback guidance. docs/dev-workflow.md provides developer-facing guidance on branching, pull request workflows, CI expectations, and deployment procedures.

Changes

Universe Documentation

Layer / File(s)	Summary
CI/CD Pipeline Reference docs/cicd.md	Documents workflow-stage overview, Universe image build process, test stage procedures, deployment handoff model using external tooling (Coolify/Watchtower) with GHCR tags, and rollback procedures tied to universe-<sha> image tags.
Developer Workflow Guide docs/dev-workflow.md	Covers branching conventions, PR review checklist, CI expectations for regular and mobile changes, local verification for non-runtime changes, end-to-end deployment flow, and rollback guidance using image tags.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

• CI/CD: Universe deployment pipeline (build → test → deploy to universe.bawes.net) #10: This PR directly implements the CI/CD and developer workflow documentation tasks for the universe branch.

Poem

🐰 A path through the cosmos so bright,
With workflows and docs shining light,
From branches to builds, to rolls both back,
The universe flows on its track! 🚀

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately reflects the main change: adding comprehensive documentation for the Universe CI/CD workflow across two new documentation files (docs/cicd.md and docs/dev-workflow.md).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}