sjat/MakerFLOSS
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
MakerFLOSS/CLAUDE.md
sjat 2755733ca0 docs: Updated todo
2026-04-14 22:11:09 +02:00

1.8 KiB
Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a documentation-only repository for the MakerFLOSS initiative at Orange Makerspace — a bi-weekly FLOSS jam-session community focused on self-hosted, open-source infrastructure. There is no build system, test suite, or application code.

Working Norms

From docs/todo/2026-04-14 TODO.md:

  • Language: English for code, docs, commits (meeting notes may be in Danish)
  • Git: Trunk-based development, feature branches, simple commit messages
  • Environments: Containerized and reproducible
  • Hardware: All setups documented with README + labeled physically
  • AI: Allowed but reviewed; no secrets in commits
  • Decisions: Lightweight markdown decision logs
  • License: FLOSS by default

Repository Structure

docs/
  infrastruktur/   # Infrastructure documentation (VPS, DNS, etc.)
  kommunikation/   # Communication materials (Facebook posts, announcements)
  møder/           # Meeting notes
  todo/            # Task lists and working norms

Infrastructure

The MakerFLOSS infrastructure is managed externally via the AnsibleBaobabV4 Ansible project (hosted at forgejo.nyumbani.baobab.band/sjat/AnsibleBaobabV4). Key facts:

  • VPS: 88.99.32.236, SSH on port 7576
  • Forgejo (self-hosted git forge): https://forgejo.makerfloss.eu, SSH on port 7577
  • Reverse proxy: Traefik with automatic Let's Encrypt TLS
  • DNS: makerfloss.eu via Gandi.net, managed declaratively through Ansible (play_dns.yml --limit makerfloss)
  • DNS records must never be edited directly in the Gandi panel — always edit host_vars/makerfloss.yml in AnsibleBaobabV4

Clone via Forgejo SSH:

git clone ssh://git@forgejo.makerfloss.eu:7577/<user>/<repo>.git