Skip to content

Install LDD: a LOGIC.md beside every source file and directory - #1773

Open
brillout wants to merge 14 commits into
mainfrom
claude/nice-einstein-g4wfd8
Open

Install LDD: a LOGIC.md beside every source file and directory#1773
brillout wants to merge 14 commits into
mainfrom
claude/nice-einstein-g4wfd8

Conversation

@brillout

@brillout brillout commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

What

Installs Logic-Driven Development per the logic-driven-development skill: a LOGIC.md describing the business logic of each file and directory containing source code, written for the technical product manager who never reads the code.

  • some-file.extsome-file.LOGIC.md, some-dir/some-dir/LOGIC.md, across the whole monorepo (the product, the driver seam, the agent-data library, the four skills, the Chrome extension, the website, the prompts, the GitHub workflows).
  • Written fresh from the code — not converted from any earlier documentation. Every file was read in full; test files get a "What the tests cover" list.
  • One vocabulary across all files (agent, driver, turn, gate, pick, handoff, checkout, location, the agent-data branch, sweep, quota boundary, …), with a per-file glossary for the project's coined terms.
  • Files with no business logic (build and test-runner configuration, styling, static assets) are named in their directory's LOGIC.md instead of getting one of their own.

Status

Work in progress on this branch: the root and packages/ files and the first slices are in; the remaining slices land in follow-up commits on this branch, then a consistency pass. No source file is modified.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB


Generated by Claude Code

…ress)

Logic-Driven Development per the logic-driven-development skill: a LOGIC.md
describing the business logic of each file and directory containing source
code, written fresh from the code for the technical product manager.

This commit carries the root and packages-level files and the first slices;
the remaining slices follow on this branch.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
The prompt compiler skips README.md and the LOGIC.md beside each prompt (and
the directory's own), as it skipped the SPEC.md docs before them. Also carries
the LOGIC.md files written since the previous commit.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcSwKgtQE6ndJYjdDitVFB
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.

2 participants