Skip to content

Add CLAUDE.md and ONBOARDING.md for developer onboarding#239

Merged
sklppy88 merged 12 commits intonextfrom
josh/ecodr-736-make-a-clear-onboarding-document-for-aztec-starter
Mar 5, 2026
Merged

Add CLAUDE.md and ONBOARDING.md for developer onboarding#239
sklppy88 merged 12 commits intonextfrom
josh/ecodr-736-make-a-clear-onboarding-document-for-aztec-starter

Conversation

@critesjosh
Copy link
Collaborator

Summary

  • CLAUDE.md — Guidance for Claude Code with build commands, architecture overview, test structure, and repo conventions
  • ONBOARDING.md — Progressive 6-phase tutorial taking Ethereum developers from reading code (browser only) to deploying on devnet, covering the Pod Racing game contract
  • README.md — Added link to the onboarding guide

Test plan

  • Verify ONBOARDING.md code snippets match current contract source
  • Verify all commands in CLAUDE.md work on a fresh clone
  • Verify links in README point to correct files

🤖 Generated with Claude Code

critesjosh and others added 7 commits February 9, 2026 17:21
CLAUDE.md provides guidance for Claude Code with build commands, architecture
overview, and conventions. ONBOARDING.md is a progressive tutorial that takes
Ethereum developers from reading code to deploying on devnet. README.md updated
with a link to the onboarding guide.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Expand the "Key insight" section in ONBOARDING.md to explain that the real
advantage isn't just easier commit-reveal, but composability in private
execution — private functions validating constraints over hidden inputs,
storing encrypted state, and interacting with public state atomically.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…-clear-onboarding-document-for-aztec-starter
@critesjosh critesjosh marked this pull request as ready for review February 11, 2026 17:33
critesjosh and others added 2 commits February 23, 2026 15:55
Resolve merge conflicts in README.md and config/local-network.json,
update stale version references in CLAUDE.md and ONBOARDING.md to
match the new pinned version.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ING.md

Explain that "private → public" means a private function enqueuing a public
function within the same transaction, not a third function type. Also adds
inline code comments, a Context explainer, a composability diagram, and
various other improvements to the onboarding tutorial.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Contributor

@sklppy88 sklppy88 left a comment

Choose a reason for hiding this comment

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

Still thinking about this but it would be ideal to have everything in include codes, even bash for the running, so we know the entire setup process also works and is updated / current. That I think requires a bit more thought re standards / sops for any code-along tutorials

critesjosh and others added 3 commits March 3, 2026 14:47
Resolve CLAUDE.md conflict by taking the more comprehensive version
from next and appending the ONBOARDING.md maintenance section from
this branch.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ONBOARDING.md code snippets were manually copied from source files with
hardcoded line numbers that went stale on every contract change. This adds
the include_code remark plugin to extract snippets from source at build time.

- Add docs:start/docs:end markers to 7 source files (19 marker pairs)
- Create docs/ONBOARDING.src.md with #include_code directives
- Install include_code, remark, remark-cli; add .remarkrc.mjs config
- Add yarn docs:build script to regenerate ONBOARDING.md
- Update CLAUDE.md with new docs workflow instructions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@critesjosh
Copy link
Collaborator Author

@sklppy88 i updated it to use include_code macros

@sklppy88 sklppy88 merged commit b8ef343 into next Mar 5, 2026
2 checks passed
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.

2 participants