# .agents/ SF repo overlay manifest
# Layout target: https://github.com/agentsfolder/spec
# Skill source:  https://agentskills.io/specification
#
# 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.

specVersion: "1.0.0"

defaults:
  mode: build
  policy: bundled:default-safe

resolution:
  enableUserOverlay: false
  denyOverridesAllow: true
  onConflict: error
  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: []

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:
  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
  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.