Skip to content

Add systems and HPC implementation guidance for coding agents - #807

Merged
yuecideng merged 1 commit into
mainfrom
codex/agent-hpc-implementation-guidance
Oct 17, 2026
Merged

yuecideng merged 1 commit into
mainfrom
codex/agent-hpc-implementation-guidance

Conversation

@yuecideng

Copy link
Copy Markdown
Contributor

Description

Coding agents currently have HPC review guidance but lack an implementation workflow when computational costs matter. Add a conditional systems/HPC implementation skill, linked from AGENTS.md, solver scaffolding, pre-commit checks, and thin Claude/Copilot adapters.

The workflow starts from representative workloads and a cost model, then covers algorithm/backend choices, batching, bounded intermediate storage, buffer ownership, transfers, synchronization, and correctness/performance tradeoffs. Benchmark guidance now uses warmed repeated measurements with explicit synchronization, separates latency and memory passes, and distinguishes device-resident from end-to-end costs. Update solver kernel paths to compute/kinematics/_warp/ and fix literal newline escapes in the Markdown report example.

Dependencies: none. No production API or runtime behavior changes.

Type of change

  • Documentation update

Validation

  • black . using Black 26.3.1: 1,299 files unchanged.
  • python docs/scripts/check_api_docs.py: 2,594/2,594 exports documented.
  • Canonical skill validation and the new Claude adapter validation passed.
  • context.py check and the focused context suite: 40 tests passed.
  • All nine benchmark Python snippets parsed; helper smoke checks covered asynchronous completion timing, warmup exclusion, output lifetime, invalid repetition counts, a real CPU memory call, and multiline report generation.
  • git diff --check passed. GPU hardware measurements were not run; this PR changes instructions and examples only.

Agent context

No topic or MAP changes are needed: implementation facts and subsystem ownership remain accurate. The reusable procedure belongs in a skill, while AGENTS.md retains the global trigger and entry point.

Screenshots

Not applicable.

Checklist

  • I have run the black . command to format the code base.
  • I reviewed affected documentation and agent context, updated it where needed, or explained why no update was needed.
  • Public API documentation gate passed; no public API changes.
  • Existing context tests and executable example checks passed; no new production tests are needed for this instructions-only change.
  • No dependency changes are required.

@yuecideng yuecideng added docs Improvements or additions to documentation agent Features related to agentic system labels Oct 17, 2026
@greptile-apps

greptile-apps Bot commented Oct 17, 2026 •

Copy link
Copy Markdown

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] This documentation-only PR appears safe to merge.

Summary

Adds a conditional implementation workflow for performance-sensitive computation.

  • Agents now have a shared workflow for costly computation.
  • Benchmark instructions now measure timing and memory separately.
  • New solver guidance points Warp kernels to the shared compute folder.

Reviews (1) · Last reviewed commit: "docs(agent): guide systems and HPC imple..." · Reviewed by Greptile

@yuecideng
yuecideng merged commit 82563fd into main Oct 17, 2026
7 of 8 checks passed
@yuecideng
yuecideng deleted the codex/agent-hpc-implementation-guidance branch October 17, 2026 11:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent Features related to agentic system docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant