Files
git.stella-ops.org/docs/AGENTS.md
master 66cb6c4b8a
Some checks are pending
Docs CI / lint-and-preview (push) Waiting to run
feat: Add guild charters and task boards for various components
- Introduced guild charters for Scanner Deno, PHP, Ruby, Native, WebService, Java, Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, UI, Zastava Observer, Zastava Webhook, Zastava Core, and Plugin Platform.
- Each charter outlines the mission, scope, required reading, and working agreements for the respective guilds.
- Created task boards for Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, and Zastava components to track progress and dependencies.
- Ensured all documents emphasize determinism, offline readiness, security, and integration with shared Surface libraries.
2025-11-01 02:21:46 +02:00

2.0 KiB

Docs & Enablement Guild

Mission

Produce and maintain offline-friendly documentation for StellaOps modules, covering architecture, configuration, operator workflows, and developer onboarding.

Scope Highlights

  • Authority docs (docs/dev/31_AUTHORITY_PLUGIN_DEVELOPER_GUIDE.md, upcoming docs/11_AUTHORITY.md).
  • Concelier quickstarts, CLI guides, Offline Kit manuals.
  • Release notes and migration playbooks.

Operating Principles

  • Keep guides deterministic and in sync with shipped configuration samples.
  • Prefer tables/checklists for operator steps; flag security-sensitive actions.
  • When work involves a specific StellaOps.<Component> project, consult both docs/07_HIGH_LEVEL_ARCHITECTURE.md and the matching dossier docs/modules/<component>/architecture.md before drafting or editing content.
  • Update docs/TASKS.md whenever work items change status (TODO/DOING/REVIEW/DONE/BLOCKED).

Coordination

  • Authority Core & Plugin teams for auth-related changes.
  • Security Guild for threat-model outputs and mitigations.
  • DevEx for tooling diagrams and documentation pipeline.

Required Reading

  • docs/README.md
  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/platform/architecture-overview.md
  • docs/dev/31_AUTHORITY_PLUGIN_DEVELOPER_GUIDE.md
  • Module-specific README and architecture dossiers for the area you are updating (for example, docs/modules/concelier/README.md and docs/modules/concelier/architecture.md)

Working Agreement

    1. Update task status to DOING/DONE in both docs/implplan/SPRINTS.md and the local TASKS.md when you start or finish work.
    1. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
    1. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
    1. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
    1. Revert to TODO if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.