Skip to content

New Project Workflow#6

Open
leandrostasi-jt wants to merge 3 commits into
Legrandk:mainfrom
leandrostasi-jt:leandrostasi-jt/issue5
Open

New Project Workflow#6
leandrostasi-jt wants to merge 3 commits into
Legrandk:mainfrom
leandrostasi-jt:leandrostasi-jt/issue5

Conversation

@leandrostasi-jt
Copy link
Copy Markdown
Contributor

This pull request introduces a comprehensive new framework for starting, planning, and reviewing brand-new projects from source documents, with an emphasis on traceability, disciplined workflow, and tool-agnostic behavioral guidelines. It introduces a new "new-project" workflow, refactors shared behavioral guidance into a core document, and adds wrappers and configuration for both Claude Code and OpenAI Codex. The changes provide new agent definitions, planning and review protocols, and installation/configuration instructions for Codex compatibility.

Major changes include:

New Project Workflow and Agent Support

  • Added a new new-project-architect agent (agents/new-project-architect.md) to synthesize requirements and architecture from source documents, ensuring all decisions are source-backed and traceable.
  • Extended the planner agent (agents/planner.md) to support new-project planning, requiring specific artifacts, enforcing a strict task file contract, and providing detailed traceability protocols. [1] [2]
  • Updated the reviewer and antagonist agents to add new-project-specific review and validation checks, ensuring all requirements, architecture, and artifacts are satisfied and traceable. [1] [2]

Shared Core Guidance Refactor

  • Extracted tool-agnostic behavioral guidelines into a new CORE.md, covering brevity, scope discipline, spec workflow, simplicity, surgical changes, and goal-driven execution. Project-specific wrappers (CLAUDE.md, AGENTS.md, codex/AGENTS.md) now reference CORE.md for shared rules. [1] [2] [3] [4]
  • Updated documentation to clarify repository layout and asset resolution for Claude Code and Codex, including new README.md and configuration files for Codex. [1] [2]

Codex Adapter and Prompt Support

  • Added Codex-specific wrappers and configuration: codex/AGENTS.md, codex/README.md, codex/config.toml, and a set of prompt wrappers for common skills and commands, ensuring seamless integration with OpenAI Codex workflows. [1] [2] [3] [4] [5] [6] [7]

These changes establish a robust, rules-driven process for greenfield project setup, planning, and review, while unifying behavioral guidance across AI coding tools.

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