Add AGENTS.md + foundational skills for AI coding agents#327
Draft
jgodwin-ai wants to merge 18 commits intoahay:masterfrom
Draft
Add AGENTS.md + foundational skills for AI coding agents#327jgodwin-ai wants to merge 18 commits intoahay:masterfrom
jgodwin-ai wants to merge 18 commits intoahay:masterfrom
Conversation
Add SKILL.md and runnable example SConstruct for the writing-rsf-flows skill. Signatures transcribed from framework/rsf/proj.py; smoke test confirms example-flow.SConstruct runs cleanly under Madagascar. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds SKILL.md (~477 lines, all 9 required sections) and a runnable example-pipeline.sh verified against a live Madagascar installation. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add skill covering the RSF two-file model, axis conventions, data types (native_float/native_complex etc.), essential tools (sfin, sfattr, sfput, sfrm, sfheadermath), binary location under $DATAPATH, header manipulation without data copy, and recovery scenarios. Includes runnable example script verified smoke-test clean. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…cenario Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Comprehensive vplot visualization skill covering sfgrey, sfgraph, sfwiggle, sfcontour, sfdots, sfbargraph — with verified examples, color scheme codes sourced from coltab.c, label escape codes from vplottext.mn, composition modes from rsf.proj, and universal parameters from sfdoc stdplot. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…nd sfcontour - plotcol=3: revert purple→magenta (authoritative: sfdoc stdplot shows '3 magenta') - Composition section: document all 8 modes (OverUnderAniso, OverUnderIso, TwoRows, TwoColumns were missing); add overview table with vppen args sourced from framework/rsf/proj.py:255-264 - zplot=: fix mechanism description to match wiggle.c:131 (zplot *= d2; half-width per trace relative to d2 interval) - sfcontour scalebar: add gotcha note that barlabel= is required alongside scalebar=y or bar is silently suppressed (contour.c:97-99) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ty, and C++ scraper claim - C1: remove invented rsf.api.error(); replace with sys.stderr/SystemExit idiom - C2: Chapel uses sf_error() via RSF module, not halt() - C3: mark .f/.jl/.java/.m extensions as having no existing M*.<ext> programs in tree - I1: include full Mpick.c comment block (was silently truncated 2 lines) - I2: C++ doc scraper matches only a single // line, not multiple lines - I3: document that HuiSconsTargets handles .cc/.cu; UserSconsTargets does not - M1: remove brittle line-number citation from doc.py reference - M2: replace non-existent 'scons test' alias with correct 'scons' invocation Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add Tier 1 C-language skill grounding all signatures in build/api/c/rsf.h and api/c/Test*.c examples; references Mpick.c as real-world worked example. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Tier 1 Python authoring skill with smoke-tested skeleton, accurate rsf.api API surface, self-doc regex, numpy shape conventions, and SConstruct integration details. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hi @sfomel and others, this is my experiment with making Madagascar more friendly for coding agents like Claude Code and Codex. I'd love it if others play around with this to see if helps or not, but right now I'm not really asking for this to be merged!
Summary
Adds agent-facing orientation and skill documentation under
src/, entirely additive — no existing files modified, no build changes.New files:
src/AGENTS.md— one-page orientation for AI coding agents (Claude Code, GitHub Copilot CLI, Codex, Gemini CLI). Covers Madagascar's mental model: RSF data plane, `sf*` compute plane, SConstruct orchestration, vplot visualization; repo map; running/discovering programs; common gotchas.All skills are Markdown with YAML frontmatter — they read as plain docs for humans and are discoverable by agent tools that honor the `SKILL.md` convention.
Motivation
Modern coding assistants work better when grounded in a project's actual mental model and conventions. Without a file like AGENTS.md, agents default to guessing from filenames — which for Madagascar tends to produce non-idiomatic results (e.g., writing `sf*` prefix inside Flow strings, forgetting vplot escape codes, mishandling RSF complex `data_format`). These docs give an agent enough orientation to produce idiomatic Madagascar code on first try.
Test plan
Notes for maintainers