Skip to content

docs(context): onboard project to Four Disciplines framework#3

Merged
michaelalber merged 1 commit intomainfrom
docs/four-disciplines-onboarding
Apr 20, 2026
Merged

docs(context): onboard project to Four Disciplines framework#3
michaelalber merged 1 commit intomainfrom
docs/four-disciplines-onboarding

Conversation

@michaelalber
Copy link
Copy Markdown
Owner

Summary

  • Restructured AGENTS.md to match the Nate B. Jones project-context template: Project Overview, Technology Stack, Architecture, Key Files, Persistent Decisions, Open Loops, Team, Available Tools, Commands, and Project Boot Ritual. Removed duplicated global coding standards (those live in the global AGENTS.md).
  • Created intent.md: coding harness architecture declaration, primary goal, 5-value priority hierarchy, tradeoff rules, autonomous vs. escalate decision boundaries, and encoded good/bad output definitions.
  • Created constraints.md: must-do and must-not-do lists (including local-first and MCP-optional rules), preferences, escalation triggers, and full quality gate table.
  • Created evals.md: three task-type test cases (file upload, RAG query, MCP graceful degradation), taste rules, CI gate commands, and rejection log scaffold.

Test plan

  • Review AGENTS.md — verify all sections present, no global standards duplicated, commands are accurate
  • Review intent.md — verify value hierarchy and tradeoff rules match your priorities
  • Review constraints.md — verify must-not-do list covers all hard project boundaries
  • Review evals.md — verify test cases and CI gate commands match the actual project setup
  • Confirm open loops section in AGENTS.md reflects known gaps accurately

🤖 Generated with Claude Code

Restructure AGENTS.md to match the Nate B. Jones project-context
template: add Project Overview, Technology Stack, Architecture,
Key Files, Persistent Decisions, Open Loops, Team, Available Tools,
and Project Boot Ritual sections. Remove duplicated global coding
standards (TDD, security rules, quality gates live in global AGENTS.md).

Create intent.md: agent architecture (coding harness), primary goal,
value hierarchy, tradeoff rules, decision boundaries, good/bad output
definitions, and persistent decisions.

Create constraints.md: must-do, must-not-do, preferences, escalation
triggers, and project-specific quality gates.

Create evals.md: three task-type test cases (file upload, RAG query,
MCP integration), taste rules table, CI gate definitions, and
rejection log scaffold.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@michaelalber michaelalber merged commit 5c8ca96 into main Apr 20, 2026
9 of 11 checks passed
@michaelalber michaelalber deleted the docs/four-disciplines-onboarding branch April 20, 2026 00:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant