2026-05-14 19:32:41 +02:00
|
|
|
# .agents/ SF repo overlay manifest
|
|
|
|
|
# Layout target: https://github.com/agentsfolder/spec
|
|
|
|
|
# Skill source: https://agentskills.io/specification
|
.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
|
|
|
#
|
2026-05-14 19:32:41 +02:00
|
|
|
# Status: SF-specific repo overlay aligned with the emerging .agents folder
|
|
|
|
|
# convention. This file indexes optional repo-owned overrides only. Bundled SF
|
|
|
|
|
# defaults, default prompts, default policies, and hidden pattern skills live in
|
|
|
|
|
# src/resources.
|
.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
|
|
|
|
2026-05-14 19:32:41 +02:00
|
|
|
specVersion: "1.0.0"
|
.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
|
|
|
|
|
|
|
|
defaults:
|
|
|
|
|
mode: build
|
2026-05-14 19:32:41 +02:00
|
|
|
policy: bundled:default-safe
|
.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
|
|
|
|
|
|
|
|
resolution:
|
|
|
|
|
enableUserOverlay: false
|
|
|
|
|
denyOverridesAllow: true
|
|
|
|
|
onConflict: error
|
2026-05-14 19:32:41 +02:00
|
|
|
precedence:
|
|
|
|
|
- project
|
|
|
|
|
- global
|
|
|
|
|
- bundled
|
|
|
|
|
|
|
|
|
|
prompts: {}
|
|
|
|
|
|
|
|
|
|
modes: []
|
|
|
|
|
|
|
|
|
|
adapters: {}
|
|
|
|
|
|
|
|
|
|
policies: {}
|
|
|
|
|
|
|
|
|
|
skills: {}
|
|
|
|
|
|
|
|
|
|
enabled:
|
|
|
|
|
modes: [] # no project overrides; SF built-in modes (ask/build/autonomous) apply
|
|
|
|
|
adapters: [] # no generated projection targets yet
|
|
|
|
|
policies: []
|
|
|
|
|
prompts: []
|
|
|
|
|
skills: []
|
.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
|
|
|
|
|
|
|
|
project:
|
|
|
|
|
name: singularity-forge
|
|
|
|
|
description: >-
|
|
|
|
|
SF is a purpose-to-software compiler. Plans milestones, triages
|
|
|
|
|
TODO inboxes, runs autonomous build cycles. The foundational
|
|
|
|
|
product contract is docs/adr/0000-purpose-to-software-compiler.md.
|
|
|
|
|
languages:
|
|
|
|
|
- typescript
|
|
|
|
|
- javascript
|
|
|
|
|
frameworks: []
|
|
|
|
|
|
|
|
|
|
x:
|
2026-05-14 19:32:41 +02:00
|
|
|
sf:
|
|
|
|
|
schemaVersion: sf-agents-overlay/v1
|
|
|
|
|
contract:
|
|
|
|
|
canonicalRepoOverlay: .agents/manifest.yaml
|
|
|
|
|
canonicalSkillPayload: SKILL.md
|
|
|
|
|
optionalSkillMetadata: skill.yaml
|
|
|
|
|
skillMetadataRequired: false
|
|
|
|
|
bundledResourceRoot: ../src/resources/
|
|
|
|
|
bundledUserSkillRoot: ../src/resources/skills/
|
|
|
|
|
bundledWorkflowSkillRoot: ../src/resources/workflow-skills/
|
|
|
|
|
bundledAgentOverlayRoot: ../src/resources/agent-overlays/singularity-forge/
|
|
|
|
|
runtimeStateRoot: ../.sf/
|
|
|
|
|
runtimeStateSourceOfTruth: false
|
|
|
|
|
projectSkillRootPurpose: optional repo-local user skills and overrides only
|
|
|
|
|
projectOverlayPurpose: optional repo-local overrides only
|
|
|
|
|
projectLearningTarget: reviewed repo-local .agents overrides proposed from .sf evidence
|
|
|
|
|
layoutFormat:
|
|
|
|
|
name: agents-folder
|
|
|
|
|
spec: https://github.com/agentsfolder/spec
|
|
|
|
|
role: repo-overlay-layout
|
|
|
|
|
canonicalSkillFormat:
|
|
|
|
|
name: agent-skills
|
|
|
|
|
spec: https://agentskills.io/specification
|
|
|
|
|
entrypoint: SKILL.md
|
|
|
|
|
agentsFolderSkillYaml:
|
|
|
|
|
status: compatibility-adapter
|
|
|
|
|
note: >-
|
|
|
|
|
agentsfolder/agents-cli currently loads .agents/skills/*/skill.yaml
|
|
|
|
|
while the AGENTS-1 README names SKILL.yaml and the
|
|
|
|
|
broader Agent Skills ecosystem uses SKILL.md. SF treats SKILL.md as
|
|
|
|
|
canonical and may generate/read skill.yaml as compatibility metadata,
|
|
|
|
|
but does not make it the source of truth.
|
|
|
|
|
runtimeGenerated:
|
|
|
|
|
repoMap:
|
|
|
|
|
path: ../.sf/repo-map/
|
|
|
|
|
gitignored: true
|
|
|
|
|
sourceOfTruth: false
|
|
|
|
|
traces:
|
|
|
|
|
path: ../.sf/traces/
|
|
|
|
|
gitignored: true
|
|
|
|
|
sourceOfTruth: false
|
.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
|
|
|
centralcloud:
|
|
|
|
|
legacy_pointers:
|
|
|
|
|
- AGENTS.md
|
|
|
|
|
- CLAUDE.md
|
|
|
|
|
- .github/copilot-instructions.md
|
|
|
|
|
- .sf/STYLE.md
|
|
|
|
|
- .sf/PRINCIPLES.md
|
|
|
|
|
- .sf/NON-GOALS.md
|
|
|
|
|
note: >-
|
|
|
|
|
These pointer / prose files predate .agents/ adoption. They are
|
|
|
|
|
kept in-tree during the transition. .agents/ is the canonical
|
|
|
|
|
source going forward; the legacy pointers point here.
|