Skip to content

DYN-10982 Document CI/local parity and single-source build commands - #17379

Merged
jasonstratton merged 2 commits into
masterfrom
DYN-10982-afc-strict-cap-guidance
Oct 7, 2026
Merged

jasonstratton merged 2 commits into
masterfrom
DYN-10982-afc-strict-cap-guidance

Conversation

@QilongTang

Copy link
Copy Markdown
Contributor

Purpose

DYN-10982 follow-up. A 2026-10-07 re-audit of master (@ 8cadc025ed) with the Agent-Friendly Codebase rubric's global caps applied literally scored Dynamo 85 before caps / 70 strict. (The earlier 100/100 had been read from the DYN-10982 branch before it merged in its final form, and didn't apply the caps.) This PR fixes the documentation-side findings. No production code changes.

Key changes:

  • CI/local parity (S2): AGENTS.md said RS0016/RS0017 "fail the build", but only CI passes /warnAsError:RS0016,RS0017 /p:PublicApiAnalyzers=true (build_dynamo_all.yml); a plain local build only warns. Added the CI-parity build to Build Commands and the proof checklist, and corrected the Blast Radius wording.
  • Linux tests (S2): the proof checklist said the DynamoCore.sln commands also work on Linux, but build_dynamo_core.yml notes dotnet test discovers no tests there. It now says builds work on Linux and tests run on Windows.
  • Static analysis (S2): states that the analyzer build is the lint step (there is no separate linter) and where formatting rules live.
  • Single-source commands (S4): the dynamo-onboarding and dynamo-dotnet-expert skills restated the build commands already mirrored in AGENTS.md and copilot-instructions.md (kept in sync by check_instruction_drift.ps1). They now point at AGENTS.md.
  • copilot-instructions.md under 250 lines (S4): 258 → 244 by folding the duplicated "API-Breaking Changes" section into "API Compatibility" and dropping two low-value sections. No rule was removed.
  • Small fixes: dynamo-skill-writer still used the old src/DynamoCoreTests path; the test/Libraries/... proof pattern now notes that names vary (e.g. NodeServicesTest/DynamoServicesTests.csproj).

Declarations

Check these if you believe they are true

Release Notes

N/A

Reviewers

@DynamoDS/eidos

Notes to reviewers:

  • The instruction-drift gate was checked with a Python re-implementation of check_instruction_drift.ps1's two checks (no pwsh on the authoring machine): 12/12 dotnet/msbuild lines and all four PublicAPI projects match between AGENTS.md and copilot-instructions.md. CI runs the real gate.
  • The test-in-CI gap (no GitHub Actions workflow on master runs the unit tests) is intentionally left to DYN-10984: Run engine tests (ProtoTest) in GitHub Actions #17370 rather than duplicated here.

FYIs

🤖 Generated with Claude Code

Addresses the 2026-10-07 AFC survey findings for Dynamo on master
(85 pre-cap, 70 strict):

- CI/local parity: AGENTS.md said RS0016/RS0017 "fail the build", but
  only CI passes /warnAsError:RS0016,RS0017 /p:PublicApiAnalyzers=true;
  a plain local build only warns. Add the CI-parity build command to
  Build Commands and the proof checklist, and correct the Blast Radius
  wording.
- Linux: the proof checklist said DynamoCore.sln commands also work on
  Linux, but build_dynamo_core.yml notes dotnet test discovers no tests
  there. Say builds work on Linux and tests run on Windows.
- Static analysis: state that the analyzer build is the lint step (no
  separate linter) and where formatting rules live.
- Command redundancy: the dynamo-onboarding and dynamo-dotnet-expert
  skills restated the build commands already mirrored in AGENTS.md and
  copilot-instructions.md (kept in sync by check_instruction_drift.ps1).
  They now point at AGENTS.md.
- copilot-instructions.md was 258 lines; fold the duplicated
  API-breaking-changes section into API Compatibility and drop two
  low-value sections (now 244 lines).
- dynamo-skill-writer still used the old src/DynamoCoreTests path; the
  test/Libraries proof pattern now notes names vary.

Drift parity re-checked: 12/12 commands and all four PublicAPI
projects match between AGENTS.md and copilot-instructions.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@QilongTang
QilongTang requested a review from a team as a code owner October 7, 2026 05:39
Copilot AI balanced review requested due to automatic review settings October 7, 2026 05:39

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See the ticket for this pull request: https://autodesk.atlassian.net/browse/DYN-10982

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The .NET skill’s build/test reference does not point to any test commands and mislabels the core solution.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Aligns developer guidance with actual CI behavior and centralizes build/test command references.

Changes:

  • Documents CI-parity builds, analyzer behavior, and platform constraints.
  • Consolidates API compatibility guidance.
  • Replaces duplicated skill commands with canonical documentation references.
File Description
AGENTS.md Adds CI/local parity guidance and corrects platform notes.
.github/​copilot-instructions.md Mirrors command guidance and removes duplication.
.claude/​skills/​dynamo-skill-writer/​SKILL.md Corrects the example test-project path.
.claude/​skills/​dynamo-onboarding/​SKILL.md References centralized build/test commands.
.claude/​skills/​dynamo-dotnet-expert/​SKILL.md References centralized guidance, but omits the test section.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .claude/skills/dynamo-dotnet-expert/SKILL.md Outdated
… label

Review follow-up on #17379: the Tech Stack row promised build and test
guidance but linked only to § Build Commands, which has no test
invocations, and labeled DynamoCore.sln as the engine solution. It now
references both § Build Commands and § After Changes — Proof Checklist
(matching dynamo-onboarding) and calls DynamoCore.sln the core solution.

Co-Authored-By: Claude Code <[email protected]>
@jasonstratton
jasonstratton merged commit a1eea9e into master Oct 7, 2026
40 of 46 checks passed
@jasonstratton
jasonstratton deleted the DYN-10982-afc-strict-cap-guidance branch October 7, 2026 17:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants