shareAI-lab / shareAI-lab/learn-claude-code

Proposal: Add a Go companion implementation

Open
#466 0 comments 0 reactions 0 assignees View on GitHub

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

  1. Would the maintainers accept a Go companion implementation in this repository?
  2. Should Go code live alongside each chapter, or under a separate top-level directory?
  3. Should the Go version cover all chapters eventually, or only selected chapters?
  4. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.