singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
singularity-forge/.agents/prompts/snippets/style.md
Mikael Hugo f3d84cd116
Some checks failed
CI / detect-changes (push) Has been cancelled
Details
CI / docs-check (push) Has been cancelled
Details
CI / lint (push) Has been cancelled
Details
CI / build (push) Has been cancelled
Details
CI / integration-tests (push) Has been cancelled
Details
CI / windows-portability (push) Has been cancelled
Details
CI / rtk-portability (linux, blacksmith-4vcpu-ubuntu-2404) (push) Has been cancelled
Details
CI / rtk-portability (macos, macos-15) (push) Has been cancelled
Details
CI / rtk-portability (windows, blacksmith-4vcpu-windows-2025) (push) Has been cancelled
Details
.agents: adopt agentsfolder/spec v0.1 as canonical agent configuration 
Replaces the fragmented (AGENTS.md + CLAUDE.md + .github/copilot-instructions.md
+ .sf/STYLE.md + .sf/PRINCIPLES.md + .sf/NON-GOALS.md) surface with a
single canonical .agents/ tree per https://github.com/agentsfolder/spec.

Structure:
  .agents/manifest.yaml         spec metadata + defaults + project info
  .agents/prompts/
    base.md                     project-agnostic base prompt
    project.md                  SF-specific: purpose-first, DB-first,
                                build pipeline, Ask/Build/YOLO model
    snippets/{style,principles,non-goals}.md
                                short pointers into .sf/{STYLE,PRINCIPLES,
                                NON-GOALS}.md for composition
  .agents/modes/{ask,build}.md  YAML front matter + human-readable body
  .agents/policies/{default-safe,yolo}.yaml
                                conservative default + YOLO override
  .agents/skills/.gitkeep       empty per spec — SF's own skills not yet
                                migrated to agentskills.io format
  .agents/scopes/.gitkeep       single-tree, no scopes yet
  .agents/profiles/.gitkeep     no overlays yet
  .agents/schemas/.gitkeep      generated by validators
  .agents/state/.gitignore      excludes state.yaml from VCS per spec

Status: spec is pre-1.0 (specVersion 0.1.0 pinned). No agent runtime
currently reads .agents/ — this is structural adoption ahead of
ecosystem support. Legacy files (AGENTS.md, CLAUDE.md, etc.) kept
during the transition; .agents/ is now the canonical surface and they
will eventually point here.

This is the reference template; centralcloud/infra, operations-memory,
oncall-mobile-android to follow.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 20:04:35 +02:00

613 B
Raw Blame History

Style — quick reference

For the full guide see .sf/STYLE.md.

  • DB access via node:sqlite DatabaseSync. Never better-sqlite3, never native addons.
  • No file-based proxies for DB state. Query the DB.
  • Comments are sparing — explain WHY a non-obvious choice was made, never WHAT the code does (the code says that).
  • Functions/classes get docstrings only when their purpose is non-obvious from the name.
  • TypeScript-first for new code under src/. JavaScript-first under src/resources/extensions/sf/ (loaded directly, no compile step beyond copy-resources).