Some checks are pending
CI — CoM Config Validation / Validate JSON Configs (push) Waiting to run
CI — CoM Config Validation / Validate YAML Configs (push) Waiting to run
CI — CoM Config Validation / Lint Shell Scripts (push) Waiting to run
CI — CoM Config Validation / Secret Detection (push) Waiting to run
CI — CoM Config Validation / Lint Markdown (push) Waiting to run
CI — CoM Config Validation / Validate CODEOWNERS (push) Waiting to run
Public, sanitized mirror of an AI orchestration command center: agents, skills, MCP servers, slash-command workflows. All infrastructure identifiers, hostnames, mesh IPs/subnets, repo paths, maintainer identity, and hardware fleet specifics scrubbed to <placeholders>; session debug logs and host-specific memory removed. No live credentials. Verified clean by automated leak sweep. See SANITIZATION.md. churchofmalware.org . authorized research only
2.0 KiB
2.0 KiB
| applyTo |
|---|
| ** |
General Coding Instructions — CoM Virtual Enterprise
Language Priorities
This repo primarily contains Markdown, JSON, Shell (Bash), Python, and YARA. The parent project (Syn_OS) is Rust-first with 92+ crates.
Formatting Rules
- Indentation: 2 spaces for JSON/YAML/HTML, 4 spaces for Python, tabs for Makefiles
- Line endings: LF (Unix-style) — never CRLF
- Max line length: 100 characters for code, 120 for markdown prose
- Trailing whitespace: strip on save
- Final newline: always include
Naming Conventions
- Agent files:
kebab-case.md(e.g.,cto-alfred.md,os-architect-advisor.md) - Skill directories:
kebab-case/withskill.mdentry point - Hook scripts:
kebab-case.shwith descriptive names (e.g.,pre-tool-validate.sh) - JSON configs:
camelCasekeys internally,kebab-casefilenames - Environment variables:
SCREAMING_SNAKE_CASE
Documentation Standards
- Every directory must have a README.md or equivalent entry doc
- Agent files follow the standard personality template (role, archetype, shadow, capabilities, constraints)
- Skills follow the standard skill template (description, usage, agents involved, example output)
- All configs must have inline comments explaining non-obvious values
Error Handling
- Shell: Use
set -euo pipefailand trap ERR for cleanup - Python: Use specific exception types, never bare
except: - JSON: Validate against schema before writing to production configs
- Always fail loudly — silent failures are the enemy
Git Workflow
- Branch naming:
type/short-description(e.g.,feat/websocket-daemon,security/hook-update) - Conventional Commits enforced:
type(scope): description - Never force-push to master
- Squash-merge feature branches for clean history
- Tag releases with semver:
v1.0.0
Dependencies
- Minimize external dependencies — prefer stdlib
- All new dependencies require supply chain audit
- Pin exact versions in requirements files
- Document why each dependency exists in a comment