Skip to content

docs(context): onboard Nate B. Jones Four Disciplines framework#1

Merged
michaelalber merged 3 commits intomainfrom
docs/four-disciplines-context
Apr 19, 2026
Merged

docs(context): onboard Nate B. Jones Four Disciplines framework#1
michaelalber merged 3 commits intomainfrom
docs/four-disciplines-context

Conversation

@michaelalber
Copy link
Copy Markdown
Owner

Summary

  • Rewrites AGENTS.md (OpenCode) and CLAUDE.md (Claude Code) to the Four Disciplines template: adds Project Overview, Tech Stack, Architecture, Key Files, Persistent Decisions, Open Loops, Team, Available Tools, and Project Boot Ritual; removes global-level content (style, git workflow) that duplicates the global config files
  • Adds intent.md: coding harness architecture, primary goal, value hierarchy (Correctness → Security → Maintainability → Performance → Speed), tradeoff rules, decision boundaries, quality indicators, anti-patterns
  • Adds constraints.md: Must Do / Must NOT Do / Preferences / Escalate / Code Quality Gates — all project-specific
  • Adds evals.md: four test cases (regulation search, section retrieval, certification query, audit coverage), five taste rules, full CI gate table

What was resolved

  • No Jira / Confluence (not used on this project)
  • No SLA (none defined)
  • Sole author: Michael K. Alber — michaelkalber@proton.me

Open loop

  • intent.md still has one [VERIFY:]: whether a .NET HTTP consumer is planned (if not, that line can be removed)

Test plan

  • Open a session in Claude Code or OpenCode and confirm the boot ritual executes against the new files
  • Verify no global-level content was accidentally removed from ~/.claude/CLAUDE.md or ~/.config/opencode/AGENTS.md

🤖 Generated with Claude Code

michaelalber and others added 3 commits April 19, 2026 16:51
…md, constraints.md, evals.md)

- Rewrite AGENTS.md to Four Disciplines template: adds Project Overview, Tech Stack,
  Architecture, Key Files, Persistent Decisions, Open Loops, Team, Available Tools,
  and Project Boot Ritual; removes global-level content (style, git workflow)
- Rewrite CLAUDE.md in parallel (Claude Code format): same structure, MCP tool IDs
  in Available Tools, no frontmatter comment block
- Add intent.md: coding harness architecture, primary goal, value hierarchy, tradeoff
  rules, decision boundaries, quality indicators, and anti-patterns
- Add constraints.md: Must Do / Must NOT Do / Preferences / Escalate / quality gates
- Add evals.md: four test cases (regulation search, section retrieval, certification
  query, audit coverage), taste rules, CI gate table

[VERIFY] items remain for: Jira project key, Confluence space, team roster, SLA target.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…e author

- Remove Jira project key and Confluence space from Project Overview (not used)
- Remove 60-second SLA from Primary Goal in intent.md (no SLA defined)
- Collapse Team section to sole author: Michael K. Alber
- Remove all Jira-related must-do / must-not / boot-ritual steps from
  AGENTS.md, CLAUDE.md, constraints.md, and intent.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@michaelalber michaelalber merged commit 48ea67a into main Apr 19, 2026
10 checks passed
@michaelalber michaelalber deleted the docs/four-disciplines-context branch April 20, 2026 00:07
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