Add a Workflows section to the Claude guide (work in progress) - #194
Open
dmartinezIPA wants to merge 2 commits into
Open
Add a Workflows section to the Claude guide (work in progress)#194dmartinezIPA wants to merge 2 commits into
dmartinezIPA wants to merge 2 commits into
Conversation
Add a Workflows subsection under Claude AI: a link-hub landing plus the first workflow, "Revive and understand inherited code" — give Claude the code and its context, iterate until it runs, and report what it changed; the advanced git tier produces an Explain-Diff-style walkthrough (credit Geoffrey Litt). Wired into the Claude sidebar in _quarto.yml. Authorship: Daniel Martinez; contributors Juan Felipe Garcia Rodriguez and Diego Quintero Mogollon. Verified against the knowledge-hub-generator QC checklist: fmt-md, vale (0 errors), quarto render, and house style. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Second Workflows page: Claude as a multi-language, multi-platform agent that lays a project's foundations, wires the just orchestration, and drives the uv -> Stata/R -> Python -> Quarto chain to a rendered deliverable. Adds a "what the stack buys you" rationale, a safe-data rule, and a starter prompt; cites the public ipa-stata-template and ipa-python-template. Added as a card on the Workflows landing and wired into _quarto.yml. Authorship: Daniel Martinez; contributors Juan Felipe Garcia Rodriguez and Diego Quintero Mogollon. Verified against the knowledge-hub-generator checklist plus an independent editorial review (Diataxis fit, no duplication, public-first framing, voice). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
kellymontano
marked this pull request as ready for review
August 12, 2026 20:27
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request Summary 🚀
What does this PR do? 📝
Adds a Workflows subsection under Software Guides → Claude AI:
software/claude/workflows/index.qmd— a link-hub landing for the section.software/claude/workflows/understand-inherited-code.qmd— the first workflow, Revive and understand inherited code._quarto.yml— wires the subsection into the Claude AI sidebar.Why is this change needed? 🤔
The existing Claude pages orient readers and show where Claude Code helps. Workflows go a level deeper: concrete, repeatable processes for the tasks where Claude does something a reference page cannot — reading, running, and reasoning about a real project. Each workflow is written to be adopted and adapted, not just read.
How was this implemented? 🛠️
knowledge-hub-generatorskill.Stacked on
release/colombia-claude-bootstrapping(this PR targets that branch, notmain) so PR #180 stays a light, independently-approvable unit.How to test or reproduce? 🧪
just fmt-md software/claude/workflows/index.qmd just fmt-md software/claude/workflows/understand-inherited-code.qmd just vale-file software/claude/workflows/index.qmd just vale-file software/claude/workflows/understand-inherited-code.qmd just preview-docs # browse Software Guides → Claude AI → WorkflowsBoth pages report 0 Vale errors and render cleanly.
Screenshots (if applicable) 📷
N/A — text pages.
Checklist ✅
_quarto.yml🤖 Generated with Claude Code