Skip to content

Document FableCodex script and state architecture #17

Description

@baskduf

Description

Add an architecture note for contributors now that the script/state structure is more mature after v0.4.4.

Suggested file: docs/ARCHITECTURE.md

Acceptance Criteria

  • Document the plugin layout.
  • Document wrapper scripts and their target Python scripts.
  • Document .codex-fable5/ local state files:
    • goals.json
    • findings.json
    • ledger.jsonl
    • state.lock
  • Document the relationship between goals, findings, and the shared codex_fable_state.py helpers.
  • Document the high-level CI/release validation flow.
  • Link the architecture doc from README.md or CONTRIBUTING.md.

Notes

Keep this concise and practical for new contributors.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions