Skip to content

docs: replicator scaffold updates — plural directory paths and skill discoverability fix #231

Description

@yvonnedevlinrh

Context

Multiple PRs updated the Replicator scaffold:

What changed

Plural directory paths

  • Commands moved from .opencode/command/ (singular) to .opencode/commands/ (plural)
  • Skills moved from .opencode/skill/ (singular) to .opencode/skills/ (plural)
  • Anyone with the old singular paths in their setup has broken references

Skill discoverability fix

What needs updating

  • Update any references to .opencode/command/.opencode/commands/ and .opencode/skill/.opencode/skills/
  • Document what replicator init actually scaffolds (currently only mentions creating .uf/replicator/ directory)
  • Note that the skill name: field is required for OpenCode skill discovery
  • Consider expanding the replicator init section to list the full directory structure it creates:
    • .uf/replicator/ — SQLite work tracking DB
    • .opencode/agents/ — coordinator.md, worker.md, background-worker.md (mode: subagent)
    • .opencode/commands/ — slash commands (in uf.* namespace per website#220)
    • .opencode/skills/ — 7 skills with proper name: frontmatter

Affected pages

  • content/docs/projects/replicator.md — lines 50–52, replicator init section
  • Any setup or quickstart guide that references the Replicator scaffold directory structure

Note

The command namespace rename from unprefixed to uf.* is tracked separately in website#220.

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation updates needednext-releaseTargeted for inclusion in next release but can be deferred if needed

    Type

    No type

    Projects

    Status
    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions