Skip to content

[research] Describe folders#3734

Merged
junaway merged 4 commits intomainfrom
research/folders
Feb 20, 2026
Merged

[research] Describe folders#3734
junaway merged 4 commits intomainfrom
research/folders

Conversation

@junaway
Copy link
Copy Markdown
Contributor

@junaway junaway commented Feb 11, 2026

Copilot AI review requested due to automatic review settings February 11, 2026 12:26
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agenta-documentation Ready Ready Preview, Comment Feb 20, 2026 10:50am

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a set of design documents describing the newly introduced folders entity, how it integrates with legacy applications (app_db.folder_id) on this branch, and how it bridges to the artifact-based application model on the main branch.

Changes:

  • Add an RFC documenting folder data model, API surface, and migration-bridge strategy to artifacts.
  • Add a PRD capturing goals, requirements, and risks for folder-based organization.
  • Add README/PR-style docs to orient reviewers and summarize implementation + validation steps.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
docs/designs/folders/RFC.md Technical RFC covering current branch behavior, mainline artifact extension, and migration/compat strategy.
docs/designs/folders/README.md Entry-point index explaining why the folder docs exist and how to navigate them.
docs/designs/folders/PRD.md Product requirements and success criteria for folder organization.
docs/designs/folders/PR.md Reviewer-facing summary including change inventory, risks, and validation guidance.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/designs/folders/PR.md Outdated
Comment on lines +5 to +8
- New entity: `folders`
- Legacy entity still in use on this branch: `app_db`
- Mainline extension (already on `origin/main`): artifact-based application model

Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These docs refer to the main branch as origin/main, which is a remote-specific ref and can be confusing in forks/local setups. Consider using main (or “the main branch”) consistently, and optionally link to the relevant migration IDs/paths for precision.

Copilot uses AI. Check for mistakes.
Comment on lines +9 to +12
This branch introduces a first-class `folders` entity and connects it to legacy applications via `app_db.folder_id`.

`origin/main` has progressed toward artifact-based applications (workflow-backed application entities), with folder scope being extended to artifact tables.
We need a coherent design that supports current branch behavior and the migration target.
Copy link

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Using origin/main in design docs is a remote-specific git ref; readers may not have an origin remote or may use a different default branch name. Consider changing this to main / “main branch” (and keep the migration IDs as the stable reference).

Copilot uses AI. Check for mistakes.
@dosubot dosubot Bot added the lgtm This PR has been approved by a maintainer label Feb 16, 2026
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings February 20, 2026 10:46
@junaway junaway marked this pull request as ready for review February 20, 2026 10:47
@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Feb 20, 2026
@junaway junaway merged commit 77e8719 into main Feb 20, 2026
5 of 6 checks passed
@dosubot dosubot Bot added the documentation Improvements or additions to documentation label Feb 20, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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

Labels

documentation Improvements or additions to documentation lgtm This PR has been approved by a maintainer size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants