research-document
ROS Agent Bootstrap
ROS Agent Bootstrap
Follow this sequence before beginning work.
1. Read operating instructions
framework/REP-SPECIFICATION.mdframework/policies/RESEARCH-POLICY.mdframework/policies/EVIDENCE-POLICY.mdframework/policies/OUTPUT-POLICY.mdframework/protocols/ARTIFACT-LIFECYCLE.mdframework/protocols/SUPERSESSION.md- Any standards or discipline-specific profiles named by the mission
2. Read current shared context
context/CURRENT-STATE.mdcontext/ARCHITECTURE.mdcontext/DECISIONS.mdcontext/KNOWN-RISKS.md- Relevant project or domain context
3. Read the assigned mission
Read only the mission and source records needed to execute it. Do not load the entire repository without a reason.
4. Execute
- Identify the largest material uncertainty.
- Form explicit hypotheses.
- Seek supporting and contradicting evidence.
- Attempt to falsify conclusions.
- Preserve source traceability.
- Use deterministic tools before generative inference where practical.
- Record failures and invalidated assumptions.
5. Record results
Create or update the appropriate canonical artifacts:
- Journal:
research/journals/ - REP:
research/packages/ - Evidence:
research/evidence/ - Hypotheses:
research/hypotheses/ - Theories:
research/theories/ - Experiments:
research/experiments/
Run ./ros registry build; registries are generated and must not be edited
manually. Then run ./ros validate.
6. Handoff
The next agent must be able to reconstruct the work, understand the current theory, and continue without additional conversational context.