Project Support Files Cheat Sheet

Sidebar

AI · Project Support Files Cheat Sheet

What each support file and folder in the learning-blog project is for, and who maintains it. Summarised from CLAUDE.md, rules/permanent_rules.md and the files themselves. Paths are relative to the website-content folder.

Loaded automatically

CLAUDE.mdThe project guide: the routing table of which rule file to read, key paths and PDF commands.
rules/permanent_rules.mdCore rules P1, P2, P4-P7, P11, P12, plus an index of where every other rule lives.
~/.claude/CLAUDE.mdYour global instructions across every project: explanation style, prompting feedback, the utilities folder, the conversation prompt.
~/.claude/projects/.../memory/MEMORY.mdClaude's index of saved notes about you and the project. The notes themselves are separate small files.

Rule files, read on demand

rules/prompt_rules.mdCourse prompt behaviour: outlines, errors and the streak. Authoritative.
rules/workflows.mdprogress, flesh out, Q&A capture, agent questions, Korean history questions.
rules/language_rules.mdLanguage lessons, profiles, accents, storage, verb deep dives (L1-L6).
rules/language_courses.mdSongs, Basic Conversation courses and script courses (L7-L9).
rules/language_syllabus.mdLevel definitions, syllabus checklists and the grammar track.
rules/language_topic.mdLanguage-neutral chapter lists for each Basic Conversation course.
rules/kanji_rules.mdKanji pages (K1-K4).
rules/programming_lesson_rules.mdPython and other programming lessons and exercise chapters.
rules/sidebar_rules.mdSidebar lessons, cheat sheets, Links and My Tools.
rules/cheat_sheet_series.mdNumbered series for cheat-sheet batch prompts.

Course tracking

rules/course_prompts.mdWhich prompts are ready to type, with a Status each. Claude keeps it current; finished courses move to Completed Courses.
rules/course_folder_mapping.mdPrefix to folder. Claude adds a row when an outline is approved. Large: searched, never read whole.
rules/course_name_index.mdFlat list of prefix to full name for older courses. Read only; not edited.
rules/suggested_topics.mdYour own file of topic ideas. Claude never edits it.
rules/pending_pdfs.mdCourses that are finished but have no combined PDF yet.
archive/Frozen: completed-course indexes and the old bucket list. Read only if you ask.

Logs that grow

sidebar-pages.mdOne entry per Sidebar page. Append or edit one entry; never read in full.
website_checks.mdThings Claude wants you to look at. Tick items off when done.
faqs/qa_with_claude.mdQuestions and answers saved with add this to q&a.
faqs/agent_questions.mdAgent and subagent questions, appended automatically.
faqs/korean_history_notes.mdSourced notes from korean history question.
project_issues.mdOpen questions for the personal multi-technology projects (PJ1-PJ3).

Reports and saved sessions

progress-reports/progress_YYYY-MM-DD_HHMMSS.txt from each progress prompt.
conversations/conversation-YYYY-MM-DD_HHMMSS.md from each conversation prompt.
rules_review_2026-10-09.mdThe tidy-up review of rules and support files.
questions_for_the_dumb_ape_man.mdDecisions from that review that were left to you, each with a default already in effect.

Inputs

Links.mdYour own raw link collection. Claude reads it for /links and never edits it.
my-tools/<name>.yamlThe spec for each My Tools page.
rules/examples/Canonical lesson files Claude copies the structure from.
styles/ and styles/courses/Genre and per-course stylesheets, linked as /styles/.... Not under content/; a site rebuild publishes changes.

Code and generated output

content/Every course, lesson and sidebar page. The site publishes every .html here.
scripts/python/PDF builders, new_course_style.py, consolidate_styles.py.
projects/<name>/Project source code, never under content/.
.gitignoreKeeps *.pdf, *.zip and *_print.html out of git.
rules.zipAn older zipped copy of the rules folder (git-ignored). The live rules are in rules/.

Skills (.claude/skills/)

/course-chapterA course outline or chapter from a prompt like react1-3.
/language-lesson /verb-deep-diveA language lesson, or a single-verb deep dive, with PDF.
/new-kanjiA kanji page, tile and badge.
/links /my-toolsLinks chapters and interactive tools.
/progress /restartThe progress report; the session wrap-up.
/rewrite /fix-namesUpdate or rename files in the html-rewrite staging folder.

Who edits what

Claude maintainscourse_prompts.md, course_folder_mapping.md, sidebar-pages.md, the three faqs/ files, progress reports, memory.
You ownsuggested_topics.md, Links.md and the my-tools/ specs.
Frozenarchive/.
Rule IDsStable (P1-P13, PL1-3, L1-L9, K1-K4, SB/LN/MT). P14 and P15 are retired.
Snapshot
Snapshot of the rule files as at 2026-11-08, summarised by reading them. Nothing was run to test it. If this sheet and a rule file ever disagree, the rule file wins, and the sheet needs regenerating. A few scratch folders are not listed.