Create project-scaffolding-skill.md via n8n

Tech/Projects/project-scaffolding-skill.md

@@ -0,0 +1,126 @@
+---
+project: project-scaffolding-skill
+type: project-plan
+status: active
+path: Tech/Projects
+tags:
+  - claude-code
+  - skills
+  - python
+  - go
+  - web
+  - homelab
+created: 2026-04-22
+updated: 2026-04-22
+---
+## Project Scaffolding Skill
+
+Fork and customize a Claude Code skill that scaffolds new projects with
+opinionated defaults across Python, Go, and web stacks. Complements the
+existing `zero-check` skill (validation) by handling the other end of the
+lifecycle (initialization).
+
+### Goals
+
+- One skill that handles project creation for Python, Go, and web work
+- Opinionated defaults baked in: uv + Ruff + Pyright for Python, Polars
+over pandas for data work, standard Go layout
+- ~12-15 project types covering real current and near-term needs — not 70
+- Deploys cleanly to Manjaro tower, ThinkPad, and Ubuntu VM
+- Lives in a future `claude-skills` monorepo alongside `zero-check`
+
+### Approach
+
+Fork `hmohamed01/Claude-Code-Scaffolding-Skill` rather than build from
+scratch. The scaffolding logic, wizard flow, and per-type templates are
+already written. Trim to the ~13 needed types and customize defaults to
+match stack preferences.
+
+Before committing to trim-vs-rebuild, read the fork's actual `SKILL.md` and
+`scaffold.py` to assess code quality. If clean, trim. If messy, rebuild
+using the draft already started (in `/home/claude/project-scaffolding/`
+from the planning session) and keep the fork as structural reference.
+
+### Scope — project types to keep
+
+Python: FastAPI, Flask, CLI (Typer), Library (PyPI), Data analysis (Polars
++ Jupyter)
+Go: Gin API, Chi API, CLI (Cobra), Module (library)
+Web: React + Vite, Astro, Hono, T3 Stack
+
+Plus static HTML/CSS as a lightweight fallback — 13 total.
+
+### Opinions to apply
+
+- Python: uv + Ruff + Pyright (not ty, not mypy). Polars default for data,
+pandas only when needed for sklearn compat. `src/` layout via `uv init
+--package`. Python 3.13 (not 3.14).
+- Ruff rules: `E4, E7, E9, F, B, I, UP, N, SIM, RET, PTH` — opinionated but
+not ALL.
+- Go: standard cmd/internal/pkg layout, Makefile included.
+- Web: TypeScript by default, Tailwind for React/Astro.
+- Every project: `src/` layout where applicable, git init + first commit,
+`CLAUDE.md` referencing zero-check skill, MIT license default.
+
+### Tasks
+
+- [ ] Fork `hmohamed01/Claude-Code-Scaffolding-Skill` on GitHub to
+`trucktrav/`
+- [ ] Clone fork to Manjaro tower
+- [ ] Read `project-scaffolding/SKILL.md` and `scripts/scaffold.py` to
+assess structure
+- [ ] Decide: trim existing vs. rebuild from scratch using drafted
+`SKILL.md` in `/home/claude/project-scaffolding/`
+- [ ] Delete unused project type references and scaffold.py logic
+- [ ] Update `SKILL.md` decision table to list only kept types
+- [ ] Swap Python defaults: mypy → Pyright, add Polars as data default,
+customize Ruff rule set
+- [ ] Update each kept reference file (or equivalent) with opinionated
+templates
+- [ ] Write `CLAUDE.md` template that references zero-check skill at
+`~/zero-check-pipeline/validate/run-all.sh`
+- [ ] Verify Go templates match existing Go project conventions
+- [ ] Decide `claude-skills` monorepo now or later — if now, create repo
+and move both skills in with symlink deploy pattern
+- [ ] Deploy to `~/.claude/skills/project-scaffolding/` on Manjaro tower
+- [ ] Test with a real new project (Python data analysis candidate: pick
+something from the photo app or Immich tooling backlog)
+- [ ] Test with the existing Go project pattern to verify Go template
+matches
+- [ ] Iterate on SKILL.md description for triggering accuracy
+- [ ] Deploy to ThinkPad and `us-test-authy` once stable
+- [ ] Update `claude-skills` README index with new skill entry
+
+### Open decisions
+
+- Monorepo now or wait until 3rd skill?
+- Include a `web-static` (HTML/CSS) type, or skip?
+- CLAUDE.md absolute path to zero-check — is `~/zero-check-pipeline/`
+correct on all three target machines?
+- Keep `scaffold.py` (programmatic scaffolding) or convert to
+pure-instructional like `zero-check`?
+
+### References
+
+- Draft skill in planning session:
+`/home/claude/project-scaffolding/SKILL.md` and `references/python-data.md`
+- Upstream: `github.com/hmohamed01/Claude-Code-Scaffolding-Skill`
+- Structural inspiration: `github.com/a5chin/python-uv` (Python template,
+not a skill — for reading)
+- Source article: `
+kdnuggets.com/python-project-setup-2026-uv-ruff-ty-polars`
+- Existing skill: `zero-check` at `~/.claude/skills/zero-check/` on
+`us-test-authy`
+
+### Next session
+
+On Manjaro tower with Claude Code:
+
+1. `gh repo fork hmohamed01/Claude-Code-Scaffolding-Skill --clone` (or fork
+via web UI, then clone)
+2. `cd Claude-Code-Scaffolding-Skill && cat project-scaffolding/SKILL.md`
+3. Decide trim vs rebuild with Claude Code
+4. Begin trimming / rebuilding
+
+
+...sent from Jenny & Travis