diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..5c13ef1 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,51 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Project Overview + +Castle Docs is a community documentation site for a collective farm and artist residency, built on **Quartz v4.5.2** (a static site generator for markdown-based sites). Content is written in Markdown with Obsidian-flavored syntax. Published at **docs.ariege.io**. + +## Commands + +```bash +npx quartz build --serve -d content # Dev server for site content +npm run docs # Dev server for Quartz framework docs (docs/ directory) +npm run check # Type checking + Prettier validation +npm run format # Auto-format with Prettier +npm test # Run tests (tsx --test) +npx quartz build # Production build (content/ directory) +``` + +Node 22+ and npm 10.9.2+ required (`.node-version`, `.npmrc` engine-strict). + +## Architecture + +**Content pipeline:** Markdown files in `content/` are processed through a three-stage plugin pipeline defined in `quartz.config.ts`: +1. **Transformers** — parse markdown (remark/rehype), extract frontmatter, resolve links, syntax highlight, render LaTeX +2. **Filters** — exclude drafts and unpublished content +3. **Emitters** — generate HTML pages, search index, RSS, sitemap, OG images + +**Key configuration files:** +- `quartz.config.ts` — site settings, plugin pipeline, theme colors/fonts +- `quartz.layout.ts` — page layout (which components appear in header/body/sidebar) + +**Framework source (`quartz/`):** TypeScript + Preact. Components are `QuartzComponent` types with optional CSS and client-side scripts. The build system uses esbuild with sass/lightningcss for styles. + +## Content Conventions + +- Markdown with YAML frontmatter (`title`, `description`, `tags`, `draft`) +- Obsidian-flavored links: `[[page-name]]` or `[[page-name|display text]]` +- Callouts: `> [!warning]`, `> [!danger]`, `> [!tip]`, etc. +- Ignored patterns: `private/`, `templates/`, `.obsidian/` +- Dates default to git modified time; override with frontmatter + +## Code Style + +- No semicolons, 100-char line width, trailing commas (Prettier config in `.prettierrc`) +- TypeScript strict mode +- ESM (`"type": "module"`) + +## Git Remote + +Hosted on Forgejo at `git.atitlan.io:padreug/castle-docs.git`. diff --git a/content/getting-started/cleaning-party.md b/content/getting-started/cleaning-party.md new file mode 100644 index 0000000..5ff2653 --- /dev/null +++ b/content/getting-started/cleaning-party.md @@ -0,0 +1,125 @@ +--- +title: Sunday Cleaning Party +description: Weekly cleaning roles, instructions, and room assignments +tags: + - chores + - cleaning + - community +--- + +# Sunday Cleaning Party + +Every Sunday at **10:00 AM**, everyone pitches in to clean the shared spaces. Pick a role below and follow the checklist. Some roles can be done solo, others work best in pairs. + +## Roles Overview + +| Role | People needed | +| ----------------------------- | ------------- | +| Toilets | 1 | +| Mop Floors | 1-2 | +| Kitchen | 1-2 | +| Utility Room | 1 | +| Clean Surfaces & Tidy Spaces | 1-2 | +| Sweep & Prepare Floors | 1 | +| Vacuum Clean | 1 | +| DJess | 1 | + +--- + +## Toilets (1 person) + +> [!important] Cloth color code +> **Red cloth** for the toilet only. **Green cloth** for surfaces (mirror, sink, etc.). + +1. Clean inside of toilet with toilet brush and cleaning vinegar, then flush +2. Wipe the whole toilet seat and top with **red cloth** and all-purpose cleaner, then dry off with red towel +3. Wipe the mirror, sink, door handles, and keys with **green cloth** and all-purpose cleaner, then dry with white towel +4. Refill toilet paper and soap if needed +5. Change hand towel (fresh towels are under the sink) +6. Put all dirty towels and cloths into the washing machine + +--- + +## Mop Floors (1-2 people) + +**Rooms:** sun hall, moon hall, entrance hall, dining hall, kitchen, utility room, and **last** the toilets. + +1. Add one cap of vinegar and one cap of black soap to the hot water (both bottles are underneath the dish washing sink) +2. Mop all the rooms listed above; change water in between as needed (you may need to wait until after lunch or evening to clean the kitchen floor) +3. Open doors so the floor dries faster +4. Put the used mop to dry on the drying rack in the utility room + +--- + +## Kitchen (1-2 people) + +1. Bring all dirty dishes to the utility room +2. Empty compost and chicken compost and clean both containers +3. Wipe all surfaces, window sill, and especially the cooking stove (and oven inside if needed) with a fresh **blue cloth** and all-purpose cleaner — put cloth into washing machine when done +4. Check and if needed clean the common shelves +5. Clean fridge and throw away old/moldy food from the common chateau shelf +6. Clean the little sink beside the door to the garden and refill soap +7. Tidy up the cupboards under the counter in the middle of the kitchen +8. Put all chairs onto the couch or outside so the floor can be cleaned + +--- + +## Utility Room (1 person) + +1. Empty all trash and recycling bins (glass, etc.) and bring to the recycling station in the right garage +2. Wash and dry all dishes and put them back in the kitchen (also empty and clean the little compost at the sink) +3. Wipe all surfaces with a fresh **blue cloth** and all-purpose cleaner (window sills, drying counter top, sinks, top of dishwasher) +4. Refill dish washing liquid and washing detergent if needed +5. Replace all blue cloths and towels (also in the kitchen) with fresh ones from on top of the blue hanging shelf — put all dirty ones in the washing machine, including dirty cloths from the drying rack behind the door and the little woven basket beside the washing machine +6. At the very end, start the washing machine: **1 hour cycle, 60 degrees** — hang up the washing later + +--- + +## Clean Surfaces & Tidy Spaces (1-2 people) + +**Rooms:** dining hall, entrance hall, moon hall, sun hall, terrace in front of house. + +1. Bring all dirty dishes you find to the utility room +2. Put all shoes into the big wooden shoe box +3. Put all personal belongings and clothes to the Lost & Found box on the table in the dining hall at the entrance of the kitchen +4. Bring instruments back to the moon hall (be gentle and careful) +5. Clean all surfaces (tables and counter tops) with a **blue cloth** and all-purpose cleaner +6. Tidy up the couches and pillows +7. At the end, put used dirty cloth into the washing machine + +--- + +## Sweep & Prepare Floors (1 person) + +**Rooms:** dining hall, entrance hall, moon hall, sun hall, staircase, kitchen, utility room. + +1. Take all small carpets from entrance halls, shake outside, and put them on the shoe box +2. Sweep all the floors with a broom +3. Put up all chairs onto the tables, sitting cushions onto the couches, and empty the floors so the other person can vacuum and mop easily +4. *Take a break while the floor is being vacuumed and mopped* +5. Put all carpets, chairs, and things back on the floors (after the floor has been mopped and is dry again) + +--- + +## Vacuum Clean (1 person) + +**Rooms:** dining hall, entrance hall, moon hall, sun hall, kitchen, utility room, office, (big yoga room if needed). + +1. Vacuum clean all the rooms listed above +2. After cleaning the carpets, fold the corners so the floor can be mopped more easily +3. Empty and clean the vacuum cleaner at the end + +--- + +## DJess (1 person) + +Set the mood for today's cleaning party! Pick the music and keep the energy going. + +--- + +## Team Players + +Some roles depend on each other. Coordinate with your team: + +- **Kitchen** + **Mop Floors** — kitchen chairs need to be moved before mopping +- **Mop Floors** + **Clean Surfaces & Tidy Spaces** — surfaces should be cleared before mopping diff --git a/content/getting-started/shared-responsibilities.md b/content/getting-started/shared-responsibilities.md index 1f9b51e..ff5a799 100644 --- a/content/getting-started/shared-responsibilities.md +++ b/content/getting-started/shared-responsibilities.md @@ -33,7 +33,8 @@ During heating season: - *TBD* ## Cleaning Schedule -- *TBD* + +Every Sunday at 10:00 AM we hold a [[cleaning-party|Sunday Cleaning Party]] where everyone picks a role and pitches in. See the full guide for role descriptions and checklists. ## Maintenance - Report issues to: *TBD*