---
title: "Developer Tooling & Workflow"
slug: "tooling"
category: "tooling"
tags: ["moc", "tooling", "github", "obsidian", "quartz", "workflow"]
status: "stable"
last_updated: 2026-08-29
summary: "Best practices for GitHub, Obsidian, Quartz, and Claude Code workflow."
---

> The tools that hold the workflow together. GitHub for code, Obsidian for notes, Quartz for publishing, Claude Code for execution.

## Pages

- [[github]]: Branching, PR hygiene, Actions, protected branches.
- [[obsidian]]: Vault structure, MOCs, daily notes, plugins.
- [[quartz]]: Configuring Quartz 4 for a public knowledge base.
- [[claude-code-workflow]]: Day-to-day patterns for shipping with Claude Code.
- [[github-actions]]: Workflow YAML structure, jobs vs steps, matrix builds, caching, secrets, concurrency guards, and reusable workflow patterns for reliable CI.
- [[github-branch-protection]]: Required reviews, status checks, linear history, push restrictions, and the bypass scenarios that silently break protection rules.
- [[github-cli]]: Core gh commands for PRs, issues, repos, and workflows; auth setup; --jq for JSON piping; and scripting patterns that replace the GitHub web UI.
- [[github-pr-workflow]]: Conventional Commits titles, squash merge defaults, auto-merge, CODEOWNERS routing, draft PR norms, and reviewer etiquette for a low-friction PR process.
- [[github-releases]]: Tag conventions, semver rules, auto-generated changelogs from PR titles, draft-then-publish release workflow, and release notes patterns.
- [[github-secrets]]: Repo vs environment secrets, OIDC for keyless cloud auth, secret scanning, rotation cadence, and why you must never echo a secret to the log.
- [[obsidian-plugins]]: The five Obsidian community plugins worth installing: Templater, Dataview, Tag Wrangler, Pandoc, and Latex Suite, with configuration notes for each.
- [[obsidian-publishing-to-quartz]]: Publish an Obsidian vault to a Quartz 4 static site: same markdown and wikilinks, frontmatter alignment, obsidian-export caveats, and deploy flow.
- [[obsidian-templates]]: Write Templater templates in Obsidian: date macros, frontmatter injection, conditional snippets, folder-specific templates, and chaining.
- [[obsidian-vault-structure]]: Design an Obsidian vault with MOCs over folders, atomic notes, daily notes as scratch, and a template on every note type.
- [[quartz-components]]: Built-in Quartz components, how to write a custom component with QuartzComponentConstructor, attaching CSS, and the three component type variants.
- [[quartz-config]]: The shape of quartz.config.ts section by section: baseUrl, ignorePatterns, theme, and the plugin arrays that control the build.
- [[quartz-debugging]]: Using --verbose to trace build issues, diagnosing broken wikilinks, missing frontmatter, and theme problems, clearing .quartz-cache, and recovery patterns.
- [[quartz-deployment]]: Deploying Quartz to GitHub Pages, Cloudflare Pages, and Vercel; wiring custom domains; setting cache headers; and the Plugin.CNAME pattern.
- [[quartz-layout]]: How quartz.layout.ts maps slot names to component arrays, defines per-page-type overrides, and uses ConditionalRender to show or hide components.
- [[quartz-plugins]]: Quartz Transformer, Filter, and Emitter plugin types; the built-in plugin set; writing a custom transformer; ordering and naming pitfalls.

## Related MOCs

- [[ai-agents/index|AI Agents]]
- [[knowledge-vaults/index|Knowledge Vaults]]
- [[ops/index|Ops]]
- [[writing/index|Writing]]