mabdalla/sawa-server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
sawa-server/docs/CLAUDE.md
mmabdalla 65a0e268c0 feat: initial commit - founding documents
2026-03-14 06:31:59 +02:00

1.2 KiB
Raw Permalink Blame History

AI Agent Instructions for Sawa Server (SS)

You are assisting with the sawa-server project.

Project Context

  • Name: sawa-server
  • Codename: SS
  • Nature of the project: Alpine Linux USB server node project. This is NOT a web app. The end product is a bootable USB stick.

Guidelines

  1. System-Level Focus: Focus on shell scripting, Alpine Linux package management (apk), system services (OpenRC), minimal disk partitioning, and network configurations.
  2. Minimalism: Alpine Linux is strictly minimal. Always prefer lightweight native tools (e.g., busybox, ash instead of bash).
  3. No Web Frameworks: Do not suggest Node.js, React, or any web frameworks unless explicitly requested for a localized control interface.
  4. Resiliency & State: The system will transition to running diskless in RAM. Data persistence requires specific Alpine tools like Alpine Local Backup (lbu). Commands must respect this ephemeral environment.
  5. Project Structure: Never use the project root folder for new files unless absolutely necessary. Place all documentation (except README.md) in the docs/ folder and organize source code into appropriate subdirectories. README.md must stay in the project root for git forge display.