📝text•6 months ago
ARCH-AEP Tiered Remediation Cycle
Run a scope-locked remediation cycle that normalizes findings, revalidates them in parallel, and clears tiers with verification evidence.
architecture
⭐1
# ARCH-AEP Tiered Remediation Cycle
Imported from curated first-party documentation sources.
## What this covers
Use this workflow when you need an orchestrated engineering review cycle with strict scope lock, tiered execution, and audit-grade evidence.
## Use this when
- Large remediation efforts spanning multiple PRs
- Parallel specialist review with shared backlog authority
- Tracking verification evidence through closure
## Expected outcomes
- Scope changes are controlled instead of creeping mid-cycle
- Severity tiers drive remediation order predictably
- Verification evidence is treated as part of done
## Source synthesis
- CHELATEDAI/docs/ARCH AGENTIC ENGINEERING AND PLANNING/workflow.md (https://github.com/mattmre/CHELATEDAI/blob/main/docs/ARCH%20AGENTIC%20ENGINEERING%20AND%20PLANNING/workflow.md)
- CHELATEDAI/docs/ARCH AGENTIC ENGINEERING AND PLANNING/orchestrator-briefing.md (https://github.com/mattmre/CHELATEDAI/blob/main/docs/ARCH%20AGENTIC%20ENGINEERING%20AND%20PLANNING/orchestrator-briefing.md)
## Dedupe notes
Condenses the core ARCH-AEP workflow and briefing docs into a single remediation-cycle entry instead of importing both separately.
## Source excerpts
### CHELATEDAI/docs/ARCH AGENTIC ENGINEERING AND PLANNING/workflow.md
## Workflow (ARCH phase)
1. Scope lock
- Define PR range and time window.
- Freeze inputs (refinement report + framework + PR list).
2. Discovery + normalization
- Orchestrator ingests `agentic-review-framework.md` and the latest refinement report.
- Normalize all findings into a single backlog with unique IDs.
- De-duplicate, merge overlaps, and assign provisional severity.
- Record backlog in `docs/ARCH AGENTIC ENGINEERING AND PLANNING/backlog-YYYY-MM-DD.md`.
3. Parallel re-validation
- Spawn specialist agents to re-validate findings against current main.
- Each agent must attach exact file paths and line ranges.
- Propose the smallest safe fix, acceptance criteria, and effort sizing (S/M/L).
4. Architecture and planning synthesis
- Orchestrator merges validated findings into a master backlog.
- Re-score and re-rank using the sorting model.
- Identify dependency chains and blockers.
### CHELATEDAI/docs/ARCH AGENTIC ENGINEERING AND PLANNING/orchestrator-briefing.md
Purpose: Quick reference for the ARCH-AEP documentation set, plus the narrative to start a new session.
Full file index: `docs/INDEX.md`
## What Exists In This Folder
- `README.md`: narrative overview and intent for ARCH-AEP.
- `workflow.md`: end-to-end workflow specification with phases, guardrails, and enhancements.
- `templates.md`: ID and branch conventions, tracker table format, and status log.
- `backlog-template.md`: template for the master backlog file.
- `backlog-index.md`: index of backlog files.
- `next-session.md`: short handoff checklist for resuming work.
- `phase-planning.md`: long-running planning record for the current cycle.
- `schedule-and-tracking.md`: cadence, gates, and milestone tracking.
- `agent-learning.md`: cross-session learnings and reusable patterns.
- `change-log.md`: scope/defer decisions with audit context.
- `risk-memo-template.md`: Critical/High risk memo template.
- `risk-memos/README.md`: storage location for risk memos.
- `phase-summary-template.md`: template for per-PR or per-phase summaries.
- `phase-summaries/README.md`: storage location for phase summaries.
- `verification-log.md`: test/build evidence mirror for PRs.
- `tracker-pointer.md`: pointer to the active tracker file.
- `tracker-index.md`: index of tracker files.
- `scope-lock-t
...
👍0
👁️0
docs