ra-h-os/AGENTS.md

RA-OS Agent Workflow (Open Source)

This file is the source of truth for AI agents and contributors working in this repository.

Scope

• This workflow applies to ra-h_os only.
• Do not require private-repo docs, handoffs, or backlog files to complete work here.

Working Rules

1. Start from main and create a branch:
   • feat/<short-name>
   • fix/<short-name>
   • docs/<short-name>
2. Keep changes small and reviewable.
3. If behavior changes, update docs in the same PR.
4. Do not commit directly to main.

Standard Dev Loop

1. Reproduce/define the problem.
2. Implement the minimal correct change.
3. Run local checks.
4. Update docs and screenshots if needed.
5. Open PR with clear summary and test notes.

Required Checks

npm run type-check
npm run lint
npm run build

Docs Map

• README.md - product overview + quick start
• docs/README.md - docs index
• docs/4_tools-and-guides.md - MCP tools + guides
• docs/6_ui.md - UI behavior
• docs/8_mcp.md - MCP setup and troubleshooting
• docs/development/process.md - contributor process
• docs/development/docs-process.md - docs maintenance process

Upstream Relationship

• ra-h_os accepts direct contributions.
• Maintainers may sync relevant changes between public and private repos.
• Public contributions should remain attributable and not be overwritten.