stratosphere-os

🌌 Stratosphere-OS

A weightless, 3-layer agentic operating system for building full-stack apps — packaged as an installable plugin for Claude Code and Google Antigravity. Install it once, run one command, and any project gets the StratosphereOS constitution, a durable memory layer, lifecycle workflows, and the right skill packs.

One source of truth → two plugins. Update the source, rebuild, and every project that updates the plugin gets your learnings.

What you get

• Constitution (AGENT.md / CLAUDE.md / GEMINI.md) — the "Lean Architect" 3-layer rules: Workflows → Orchestration → Execution, with strict precedence and token-efficient, deterministic behavior.

• 🚀 The Agentic Workflow - slash commands for the whole dev lifecycle:

  • Stage 0: Workflows to manage the environment and workflow.
  • Stage 1: Workflows to deconstruct the problem and customer needs.
  • Stage 2: Workflows for automated architectural blueprints and logic mapping.
  • Stage 3: Workflows for full-stack implementation via "vibe coding"
  • Stage 4: Workflows for continuous feedback loops to ensure production-ready quality.

  Stage	Command	File	When to use	Reads	Produces
  0	/0a_start-session	0a_start-session.md	Begin any session	STATUS, relevant memory	synced context
  0	/0b_stop-session	0b_stop-session.md	End any session	session work	updated memory, lint, handoff
  0	/0c_handoff	0c_handoff.md	Hand to a fresh session	conversation	.tmp/handoff_*
  0	/0d_nightly-consolidation	0d_nightly-consolidation.md	End-of-day maintenance (AFK)	sessions, .memory/*	consolidation plan
  1	/1a_research	1a_research.md	Research domain (problem vs. competitive, quick vs. deep)	memory	docs/research/
  1	/1b_concept-framing	1b_concept-framing.md	Frame a fuzzy idea	GLOSSARY, BACKLOG_MAP	discovery brief, [[G-xxx]]
  2	/2a_write-prd	2a_write-prd.md	Turn a brief into a PRD	brief, memory	PRD doc + parent issue
  2	/2b_interface-design	2b_interface-design.md	Design interface (UI or non-UI contract)	PRD	design blueprint / contract
  3	/3a_create-issue	3a_create-issue.md	Slice a PRD into work	PRD	vertical-slice issues
  3	/3b_sprint-planning	3b_sprint-planning.md	Sequence a sprint	BACKLOG_MAP	sprint plan
  3	/3c_implement-issue	3c_implement-issue.md	Build a slice (TDD)	issue, ARCHITECTURE, UX	code + tests
  4	/4a_verify-and-ship	4a_verify-and-ship.md	Verify a slice (AC↔test coverage), then open a traceable PR	issue, tests, design doc	gap report + PR
  4	/4b_audit-architecture-drift	4b_audit-architecture-drift.md	Find structural drift	target dir, .memory/*	.tmp/refactor-proposal.md

• Installer — /stratosphere-setup scaffolds the project: memory layer, workspace rules, constitution, and an interactive skill-pack setup. Safe to re-run (diff-aware) as an upgrade path.

• First-party skills — micro-tdd (autonomous, token-efficient TDD) and plan-html (interactive HTML plans/matrices/micro-apps).

• On-demand skills — database, React/web, React Native, and design packs are fetched only when a project needs them (see src/external-skills.json).

Design tooling: Google Stitch is the default design tool when enabled (Stitch Status: yes); no-Stitch projects use reference-driven native design (Path B in 2b_interface-design). Brand tokens live in .memory/DESIGN.md (Google Labs DESIGN.md spec) and structural rules in .memory/DESIGN_RULES.md. The optional design skill pack (impeccable) is polish on top, not a replacement.

Assumptions

StratosphereOS assumes a React + Tailwind + shadcn/ui UI stack by default. Non-UI features are handled by the Path C interface contract in 2b_interface-design. A project can adopt another stack by superseding DR-004/DR-005 (see memory-protocol.md §3) with explicit user confirmation.

Install

New to agentic coding? The easiest way to install StratosphereOS is to let your AI agent do it. Open Claude Code or Google Antigravity and paste this one prompt into the chat:

Install StratosphereOS from this repository: https://github.com/PatN-git/Stratosphere-OS

The agent follows the instructions below and does the rest. You'll be asked a couple of quick questions (install scope, and whether to install any missing dependency). Prefer to do it by hand? See Manual install.