Skip to content

Incomplete migration - confusing documentation. #41

@smolcompute

Description

@smolcompute
  • commands/load-dynamic-requirements.md is still shouting about ${PAI_DIR}/context/CLAUDE.md; that pointer is now dead since the context directory was dropped. Until it’s rewritten to enumerate skills instead of context files, the loader hook will try to fetch missing files and stumble.

  • UFC documentation (documentation/ufc-context-system.md) hasn’t caught up with the skills era, so anyone reading it will still think the agent hunts through context/ manually.

  • mentions of a global/ and kai.md file, yet these are confusingly absent in the repo. Every researcher agent profile tells Kai to read ${PAI_DIR}/global/KAI.md before using them (agents/claude-researcher.md:16, same for Gemini and Perplexity).

  • Overall, while promising, the current documentation is confusing because it focuses more on what the system might be able to do in the future than on explaining how its parts function in the present. It's not user friendly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions