huyhandes / huyhandes/LazyCoding
10x-implement branching: conventional names, squash lifecycle, trailer ledger
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 1
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
What
Rework 10x-implement's runtime branching in target repos: conventional branch names, squash-only integration and landing, durable trailer ledger, monitoring cheat-sheet. Design agreed in a grilling session on 2026-09-04.
Naming grammar
| Object | Pattern | Example |
|---|---|---|
| Chunk branch | <type>/<spec>/<slug> |
feat/auth-mvp/endpoints |
| Integration branch | integrate/<spec> |
integrate/auth-mvp |
| Worktree | .worktree/<spec>/<slug> |
.worktree/auth-mvp/endpoints |
| Fallback branch | <type>/<spec> |
refactor/config-purge |
<type>from the closed listfeat fix docs refactor perf test chore; the spec's primary type headlines the landing commit.<spec>/<slug>: kebab-case, ASCII, ≤30 chars; slug stable across rounds (name reused, branch re-created per round).- No
10x/prefix in branch names; the skill's fingerprint moves to commit trailers (git log --grep='^10x-').
Lifecycle (squash twice)
- Create worktree + branch per chunk
- Coder: small TDD commits on the chunk branch
- Merger: round 1
checkout -B integrate/<spec> <base>(never reset after),git merge --squashper chunk in dependency order → one commit per chunk, subject<type>: <summary> (round <n>), trailer10x-chunk: <type>/<spec>/<slug> - Gates; cleanup for clean+passing chunks:
worktree remove+branch -D - Reviewer:
git diff <base>...integrate/<spec> - Ship (orchestrator):
checkout <base> && merge --squash integrate/<spec>→ landing commit →branch -D integrate/<spec>
Landing commit (the only durable survivor)
<type>(<spec>): <run summary>
10x-chunk: <type>/<spec>/<slug> · round <n> · check: <result>
10x-round: <n> · hard findings: <k> → <slugs>
10x-spec: <spec>
Files
skills/10x-implement/references/BRANCHING.md(new): grammar, lifecycle, templates, cheat-sheetskills/10x-implement/SKILL.md: multiplier 3, Setup, Decompose (spec/type), Merge, Review, new Ship step, fallback branchagents/10x-coder.md,agents/10x-merger.md(squash sequence,-Dcleanup, chunk template),agents/10x-reviewer.md- Re-run
scripts/install.py
Contributor guide
No contributing guide indexed for this repository
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 with skills/10x-implement/references/BRANCHING.md and skills/10x-implement/SKILL.md, then compare the requested lifecycle with agents/10x-coder.md, agents/10x-merger.md, and agents/10x-reviewer.md. Update the named files for branch grammar, squash integration and landing, trailers, cleanup, and the Ship step, then re-run scripts/install.py.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- git, python
- Domain
- tooling
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 68/100