Skip to content
This repository was archived by the owner on Sep 23, 2025. It is now read-only.

Commit 3a010ce

Browse files
committed
simplify CLAUDE.md
1 parent 390541e commit 3a010ce

File tree

1 file changed

+9
-19
lines changed

1 file changed

+9
-19
lines changed

CLAUDE.md

Lines changed: 9 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,21 @@
11
# CLAUDE.md
22

3-
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
3+
## Overview
44

5-
## Memory Bank Design Context
5+
The Socratic Shell documents my journey trying to build a collaborative partner that can empower me to tackle anything and everything.
66

7-
@src/memory-bank/README.md
7+
The repository combines an mdbook (found in `src`) with various code experiments. A summary of everything we are doing can be found in the mdbook summary:
88

9-
### Maintenance & Workflow
10-
The mdBook whose table of contents lies in `src/SUMMARY.md` must be kept current as design evolves.
11-
The table of contents can be useful to find sources of additional information about the memory bank design.
9+
@src/SUMMARY.md
1210

13-
### Checkpointing
11+
## Conventions for working in this project
1412

15-
When asked to "checkpoint our work", remember to take the following steps:
16-
- Update [Current Design State](./src/memory-bank/current-state.md) with new insights/discoveries
17-
- Move completed items from Open Questions to Key Design Decisions
18-
- Document new principles discovered in the [Design Foundation](./src/memory-bank/design-foundation.md)
19-
- Add new questions to cover design pivots in the [FAQ](./src/memory-bank/faq.md)
13+
When exploring new ideas, we keep most of our documentation in the mdbook, including goals, architectural design, and key implementation details.
2014

21-
## Dialectic testing tool
15+
However, we do not use the mdbook to store transient information like the set of ongoing tasks. Those are maintained in github issues:
2216

23-
@src/dialectic/README.md
17+
@src/prompts/project/github-tracking-issues.md
2418

25-
## Socratic Shell Conventions
19+
When writing code, we use AI insight comments to capture key insights:
2620

27-
@src/prompts/project/github-tracking-issues.md
2821
@src/prompts/project/ai-insights.md
29-
30-
@src/SUMMARY.md
31-
(Complete architecture, implementation details, research archive)

0 commit comments

Comments
 (0)