infrastructure-autoresearch git:20260525.f50de94A

Immutable. This exact content is served forever at /api/v1/blob/2aecb7ec853f3de7.

---
name: infrastructure-autoresearch
description: Skill for deterministic AutoResearch readiness planning. Use when adding, validating, or documenting opt-in autoresearch.yaml controls, stage-gate readiness, evidence-grounded claims, artifact readiness reports, or AutoResearchClaw-inspired workflow checks in template projects.
---

# AutoResearch Readiness

Use this module for deterministic planning and readiness validation. It adapts
reviewed AutoResearchClaw design ideas as file-backed template controls, not as
an autonomous research agent.

## Commands

```bash
uv run python -m infrastructure.autoresearch.cli validate --project template_code_project --fail-on-issues
```

## Public API

```python
from infrastructure.autoresearch import (
    AutoResearchConfig,
    AutoResearchIssue,
    AutoResearchPlan,
    AutoResearchReport,
    build_autoresearch_plan,
    load_autoresearch_config,
    parse_string_sequence,
    validate_autoresearch_plan,
    write_autoresearch_report,
)
```

`validate_autoresearch_plan(..., phase="intrinsic"|"extrinsic"|"all")` splits
pre-write structure checks from post-write artifact checks.

## Configuration

Project-local `autoresearch.yaml` supports:

- `enabled`
- `strict`
- `topic`
- `quality_checks`
- `stage_gates`
- `required_artifacts`

`stage_gates` must use exact stage names from `pipeline.yaml`.

## Guardrails

Keep v1 deterministic: do not add network calls, LLM calls, generated-code
execution, or autonomous loops here. Delegate execution and validation to the
existing pipeline, project, validation, and reporting modules.