shareAI-lab / shareAI-lab/learn-claude-code
Proposal: Add a Go companion implementation
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 77.2k
- Forks
- 12.4k
- Avg merge
- 2d 5h
- Merged PRs (30d)
- 6
Description
Background
This repository currently explains the agent harness concepts through Python implementations. I would like to contribute a Go companion implementation for developers who are more familiar with the Go ecosystem.
The goal would be to preserve the existing teaching objectives and chapter progression while expressing the same mechanisms in idiomatic Go. This would be a companion implementation, not a replacement for the Python version.
Proposed scope
I would start with a small pilot, such as s01_agent_loop, rather than submitting all chapters at once.
The pilot would:
- Preserve the behavior and teaching focus of the Python version.
- Keep the implementation minimal and easy to read.
- Avoid production-oriented abstractions and unnecessary hardening.
- Include Go-specific documentation and run instructions.
- Be reviewed manually and kept aligned with the corresponding Python chapter.
If the pilot is acceptable, the remaining chapters could be added incrementally in focused PRs.
Questions
- Would the maintainers accept a Go companion implementation in this repository?
- Should Go code live alongside each chapter, or under a separate top-level directory?
- Should the Go version cover all chapters eventually, or only selected chapters?
- Which Go version and dependency policy should the implementation follow?
I would appreciate feedback on the scope and directory structure before starting the implementation.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the existing Python implementation for the s01_agent_loop chapter and compare its teaching objectives with the proposed Go pilot. Before coding, get maintainer decisions on directory placement, supported Go version, dependencies, and eventual chapter coverage. Done would be an approved, minimal Go companion with Go-specific documentation and run instructions that remains aligned with the Python chapter.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go, python
- Domain
- developer-experience, documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100