How jaabster-dev/u-gas works
U-GAS helps a person start or resume an AI-assisted project while keeping durable project context in ordinary files. The main workflow is: use the Starter to generate a prompt, give it to an AI agent with persistent file access, and return material results so project state stays current. PICA files and agent guidance support continuity; standalone scripts check project/distribution contracts, pending handoffs, and Git branch health. The README documents the workflow, but the Starter and guidance implementations were not sampled, so their internal links are limited to documented relationships.
Main entry points: index.html Project Starter · pica_contract.py PICA contract helpers · pica PICA controls · check_u_gas.py U-GAS self-check
Components 17
Project onboarding
- Project Starter
starter/index.html
Project continuity
- Project workspace
- PICA controls
templates/pica
Agent guidance
- Resume guidance
ai/SESSION_CONTINUITY.md - Agent governance
ai/GOVERNANCE.md - GitHub workflow
ai/GITHUB_WORKFLOW.md - Safe large-file patches
ai/LARGE_FILE_PATCHING.md - Multi-agent coordination
ai/MULTI_AGENT_COLLABORATION.md - Repository structure guidance
ai/REPOSITORY_STRUCTURE.md - Compliance guidance
ai/COMPLIANCE.md - Operational skills
skills
Local checks
- PICA contract helpers
scripts/pica_contract.py - U-GAS self-check
scripts/check_u_gas.py - Handoff contract checker
scripts/check_handoff.py - Git branch health
scripts/check_repository_health.py
Other components
- Project owner
- AI coding agent
Connections 14
- Project owner → Project Starter: chooses mode
README.md - Project Starter → AI coding agent: generates prompt
README.md - AI coding agent → Project workspace: creates or continues
README.md - AI coding agent → PICA controls: reads and updates
README.md - AI coding agent → Resume guidance: follows continuity
README.md - AI coding agent → Agent governance: follows guidance
- AI coding agent → GitHub workflow: follows guidance
- AI coding agent → Safe large-file patches: follows guidance
- AI coding agent → Multi-agent coordination: follows guidance
- AI coding agent → Repository structure guidance: follows guidance
- AI coding agent → Compliance guidance: follows guidance
- AI coding agent → Operational skills: uses skills
- U-GAS self-check → PICA contract helpers: uses helpers
scripts/check_u_gas.py - PICA contract helpers → PICA controls: loads templates
scripts/pica_contract.py