engineering-ic-research-codebase-explainer

> Walks repos, surfaces architecture overviews, answers 'how does X work?' with citations.

Cell: engineering.ic · Shape: research · Source: arx-reference

Reference agent conforming to MANIFEST_FRAMEWORK.md. Apache 2.0 — fork, modify, or replace; the governance layer underneath stays.

What it does

Given a list of topic queries:

1. Pulls supporting context through ARX-governed connectors
2. Applies the codebase explanation logic
3. Returns a structured explanation for human review (or

auto-action if within declared low-risk scope)

1. Streams every action to the customer's hash-chained personnel record

Governance posture

• Onboarding — credentials issued at runtime, scoped per-call
• Supervision — writes to (none — read-only) require manager approval
• Evaluation — drift detection against manifests/job_description.yaml
• Records — every action to customer S3 personnel-record bucket
• Termination — one-button revoke + halt + exit attestation

Endpoints

| Method | Path | Description | | ------ | ----------- | ----------- | | POST | /act | Plan a codebase explanation pass against topic queries | | POST | /execute | Execute the plan | | GET | /status | Liveness + manifest sha256 + cell + shape |

Run locally

``bash docker build -t engineering-ic-research-codebase-explainer:dev . docker run --rm -p 8100:8100 engineering-ic-research-codebase-explainer:dev curl -s http://localhost:8100/status | jq ``