Skip to content

Commit 06dbdc4

Browse files
committed
cleanup AGENTS.md
1 parent b1d64d7 commit 06dbdc4

1 file changed

Lines changed: 0 additions & 44 deletions

File tree

AGENTS.md

Lines changed: 0 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -126,48 +126,6 @@ When writing complex features or significant refactors, use an ExecPlan (as desc
126126

127127
When writing complex features or significant refactors, use an ExecPlan (as described in PLANS.md) from design to implementation.
128128

129-
## PIOSEE Decision Model (Adopted)
130-
131-
Use this as a compact, repeatable loop for anything from a one‑line bug fix to a multi‑quarter program.
132-
133-
### P — **Problem**
134-
135-
**Goal:** State the core problem and what “good” looks like.
136-
**Ask:** Who’s affected? What outcome is required? What happens if we do nothing?
137-
**Tip:** Include measurable target(s): error rate ↓, latency p95 ↓, revenue ↑, risk ↓.
138-
139-
### I — **Information**
140-
141-
**Goal:** Gather only the facts needed to move.
142-
**Ask:** What do logs/metrics/user feedback say? What constraints (security, compliance, budget, SLA/SLO)? What assumptions must we test?
143-
144-
### O — **Options**
145-
146-
**Goal:** Generate viable ways forward, including “do nothing.”
147-
**Ask:** What are 2–4 distinct approaches (patch, redesign, buy vs. build, defer)? What risks, costs, and second‑order effects?
148-
**Tip:** Check guardrails: reliability, security/privacy, accessibility, performance, operability, unit economics.
149-
150-
### S — **Select**
151-
152-
**Goal:** Decide deliberately and document why.
153-
**Ask:** Which option best meets the success criteria under constraints? Who is the decision owner? What’s the fallback/abort condition?
154-
**Tip:** Use lightweight scoring (e.g., Impact×Confidence÷Effort) to avoid bike‑shedding.
155-
156-
### E — **Execute**
157-
158-
**Goal:** Ship safely and visibly.
159-
**Ask:** What is the smallest safe slice? How do we de‑risk (feature flag, canary, dark launch, rollback)? Who owns what?
160-
**Checklist:** Traces/logs/alerts; security & privacy checks; docs & changelog; incident plan if relevant.
161-
162-
### E — **Evaluate**
163-
164-
**Goal:** Verify outcomes and learn.
165-
**Ask:** Did metrics hit targets? Any regressions or side effects? What will we keep/change next loop?
166-
**Output:** Post‑release review (or retro), decision log entry, follow‑ups (tickets), debt captured.
167-
**Tip:** If outcomes miss, either **iterate** (new Options) or **reframe** (back to Problem).
168-
169-
---
170-
171129
### Benchmarking workflow (repository-wide)
172130

173131
The `scripts/run-single-benchmark.sh` helper is the supported path for spot-checking performance optimisations. It builds the chosen module with the `benchmarks` profile, constrains the benchmark selection to a single `@Benchmark` method, and when `--enable-jfr` is supplied it enforces repeatable profiling defaults (no warmup, ten 10-second measurements, one fork) while clearly reporting the destination of the generated JFR recording. Lean on this script whenever you need a reproducible measurement harness.
@@ -466,7 +424,6 @@ When writing complex features or significant refactors, use an ExecPlan (as desc
466424
467425
## Working Loop
468426
469-
* **PIOSEE first:** restate Problem, gather Information, list Options; then Select, Execute, Evaluate.
470427
* **Plan:** small, verifiable steps; keep one `in_progress`, or follow PLANS.md (ExecPlans)
471428
* **Change:** minimal, surgical edits; keep style/structure consistent.
472429
* **Format:** `mvn -o -Dmaven.repo.local=.m2_repo -q -T 2C formatter:format impsort:sort xml-format:xml-format`
@@ -657,7 +614,6 @@ Immediately after creating any new Java source file, add the signature comment (
657614
* **Files touched:** list file paths.
658615
* **Commands run:** key build/test commands.
659616
* **Verification:** which tests passed, where you checked reports.
660-
* **PIOSEE trace (concise):** P/I/O summary, selected option/routine, key evaluate outcomes.
661617
* **Evidence:**
662618
*Routine A:* failing output (pre‑fix) and passing output (post‑fix).
663619
*Routine B:* pre‑ and post‑green snippets from the **same selection** + **Hit Proof**.

0 commit comments

Comments
 (0)