Skip to content

docs: add customization system documentation and roadmap#7

Merged
Gaubee merged 1 commit intomainfrom
docs/customization-roadmap
Dec 19, 2025
Merged

docs: add customization system documentation and roadmap#7
Gaubee merged 1 commit intomainfrom
docs/customization-roadmap

Conversation

@Gaubee
Copy link
Copy Markdown
Collaborator

@Gaubee Gaubee commented Dec 19, 2025

Summary

Add comprehensive documentation for the workflow/MCP customization system and project roadmap.

New Documentation

1. Prompt Customization (06-configuration/prompt-customization.md)

  • Template syntax with configurable PREFIX/SUFFIX (default: {​{KEY}})
  • YAML frontmatter for custom syntax and ALIAS mapping
  • Built-in placeholders: USER_RULES, CUSTOM_INSTRUCTIONS, DATETIME, CWD
  • Priority: user > builtin

2. Workflow Config (06-configuration/workflow-config.md)

  • Zod schema per workflow for type-safe configuration
  • Tools merge syntax with ! prefix for removal
  • Common config: tools, permissionMode, prompts
  • Workflow-specific config: openspec (coder), output (research), etc.

3. Roadmap (08-roadmap/index.md)

Near-term (v0.2):

  • Project scope: .jixoflow/ directory support
  • Roles system: multi-profile configuration spaces

Mid-term (v0.3):

  • Plugin system
  • Remote configuration
  • Team collaboration

Long-term:

  • Visual configuration UI
  • Multi-runtime support (Node.js, Bun)
  • Agent marketplace

Design Notes

  • Project scope and user scope are parallel (same dimension)
  • Roles are a separate dimension for profile isolation
  • Default role is "user" (current user/ directory)
  • Roles structure: roles/{name}/{mcps|workflows|user}

- Add prompt-customization.md: template syntax, placeholders, frontmatter config
- Add workflow-config.md: Zod schema, tools merge syntax (!prefix)
- Add 08-roadmap/index.md: project scope, roles system, future plans
- Update configuration index with new pages
@Gaubee Gaubee merged commit a7dacdd into main Dec 19, 2025
3 checks passed
@Gaubee Gaubee deleted the docs/customization-roadmap branch December 19, 2025 13:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant