Skip to content

evanharmon1/harmon-devkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Harmon DevKit

My personal developer kit: reusable code templates and boilerplates for various stacks (Docker Compose, Ansible, shell scripts, serverless functions, etc.), standalone scripts, and AI assets (skills, prompts, agents). Also a general home for code that doesn't really fit anywhere else.

Author: Evan Harmon

Validate Build Security Copier Maintained Contributions Welcome

Part of harmon-stack

This repo is part of harmon-stack — my personal stack of homelab, dev-tooling, and automation repos that work together.

Repo What it is
harmon-init Copier template that bootstraps & standardizes new repos (CI/CD, devcontainers, AI steering, tooling).
harmon-devkit (this repo) Reusable boilerplates & code templates, standalone scripts, and AI assets (skills, prompts, agents).
harmon-dotfiles Shell & app dotfiles, managed declaratively with chezmoi.
harmon-ops Personal machine bootstrapping, package management & dev-environment setup across macOS/Windows/Linux.
harmon-infra Homelab infrastructure as code — Terraform, Ansible, and Docker Compose services.

Repository Structure

Directory Contents
templates/ Copy-paste boilerplates organized by category — see the template index below
scripts/ Standalone scripts and utilities (AppleScript/Automator apps, command snippets)
ai/ AI assets — skills, prompts, agents, rules, evals, etc. — see the AI assets index below
snippets/ Small reusable code snippets (work in progress)
docs/ Project docs, e.g. the new-project checklist

Template Index

Template Category Description
ansible.md Ansible Standard Ansible project directory structure and setup notes
docker/genericStack Docker Generic multi-service Compose sandbox (Ubuntu, nginx, optional DB stack with Postgres/memcached/Adminer) plus dc* helper scripts
docker/n8n-compose Docker n8n workflow automation behind Traefik with automatic HTTPS (Let's Encrypt)
scriptTemplates/shellScriptTemplate.sh Scripts Shell script starter with safe defaults, traps, and arg parsing
scriptTemplates/pythonScriptTemplate.py Scripts Python CLI starter with argparse, logging, and validation
scriptTemplates/goScriptTemplate.go Scripts Go CLI starter with flag parsing, logging, and validation
serverlessFunctionTemplates/awsLambda.py Serverless AWS Lambda handler (Python) with input validation and error responses
serverlessFunctionTemplates/gcpFunction.py Serverless Google Cloud Function (Python/Flask) with input validation and error responses
serverlessFunctionTemplates/netlifyFunction.js Serverless Netlify Function (Node.js) that fetches and returns JSON from an API
webTemplates/netlifyForm.html Web Netlify-ready HTML contact form with honeypot spam protection

See templates/README.md for conventions and per-category details.

AI Assets

ai/ collects reusable AI assets organized by type — skills/, prompts/, agents/, rules/, evals/, tools/, workflows/, mcp/, knowledge/, and memories/. Most are placeholders for now; the populated area is skills, which follow the Agent Skills convention (a SKILL.md with name/description frontmatter).

Skill Status Description
design/explore-designs Draft Guides using Claude Design to explore design directions across your frontend stack
design/create-design-system Placeholder Design-system setup
design/design-handoff Ready Implements a Claude Design .tar.gz handoff into a real codebase — reconcile an existing design system or bootstrap a new one (tokens → shadcn/Tailwind v4 OKLCH, /brand, contrast + licensing gates)
repo/standardize-repo Ready Applies the harmon-init Copier template's conventions to a repo — scaffold a new repo, adopt the template into an existing one, or audit drift from the standards. Bundles the authoritative repo-conventions catalog.

Inspired by Other Boilerplate Repos

Setup & Installation

If there isn't an existing template in this repo, start with looking at the https://github.com/ChristianLempa/boilerplates repo for an existing boilerplate there. There is a cli tool to use boilerplates from that repo and you can integrate other repos.

Requirements

Bootstrap

Install required software to run other project installers and task runners task bootstrap

Install

Install required dependencies task install

Usage

Templates are meant to be copied into your project and adapted — there is no scaffolding CLI (yet). Browse the template index, copy the file or directory you need, and edit the placeholders (names, ports, environment variables) for your project. Each template directory has a README with specifics.

Task Runner

Taskfile.yaml

Testing

Validate

task validate

Security

task security

Linting, Formatting, Conventions, Style Guidelines, etc

  • .pre-commit-config.yaml
  • .shellcheckrc
  • .ansible-lint

About

My boilerplates for various stacks such as Docker Compose, Ansible, Terraform, shell scripts, etc.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors