Sred Project Organizer

SRED Project Organization

SRED expects projects to be presented in a particular format. Take the list of projects that have been worked on in the past year, and summarize them into the format expected by SRED, with the supporting evidence. Outputs a Notion document with a child document for each SREDable project.

Prerequisites

Before starting make sure that Github, Notion and Linear can be accessed. Notion and Linear should be connected using an MCP. Github can be connected with an MCP, but if you have access to the gh CLI tool, you can use that instead.

If any of these can't be accessed, prompt the user to grant access before proceeding.

Process

Step 1

Prompt the user for a link a Notion document, which is a Work Summary for the previous year produced by the sred-work-summary skill.

Ensure:

• The notion links to a valid document that roughly matches this format:

# Projects

## [Project Name]
*Summary*: [X] PRs, [X] Notion docs, [X] Linear tickets

### Pull Requests [X]
*[repository name]
[Links to all the PRs]
- [link] - [Merge date]

### Notion Docs [X]
[Links to all the Notion docs]
- [link] - [Creation date]

### Linear Tickets [X]
- [link] - [Creation date]

Step 2

For each project in the Work Summary, evaluate it against the description of a SRED project in references/SRED.md. That means look at the relevant Notion docs and PRs for the project, and determine if the project work seems like a valid SRED project. Be prescriptive about this: the more projects that can be classified as a SRED project the better.

Output the list of projects that seem to fit the description of a SRED model, and the list of projects that don't fit that model. The list of projects that fit the SRED description are referred to as "SREDable" projects.

Ensure:

• All the projects in the Work Summary have been classified as SREDable or not.

Step 3

Ask the user whether the list of SREDable projects is correct. Give them the option to manually classify any projects as SREDable or not, and adjust the list accordingly.

Step 4

Create a private Notion document called "SRED Project Descriptions". Output the full link to this document.

Step 5

For each SREDable project, go through a series of steps.

Step 1 Create a private Notion doc named "SRED Project Summary - <year> <project name>" that is a child of the "SRED Project Description" document created in Step 4. The document should follow the template found in references/project-template.md.

Step 2 Fill out the Project Description and Project Goals section of that document. Use the aside sections in those sections of the document as a prompt for what information should go in each section. Use all the information for each project gathered in the Work Summary. Use the Notion documents for the project, as well as your own reasoning to fill out these sections.

Ensure:

• The project description should be no more than 100 words.
• The project goals should be no more than 100 words.

Step 3 Provide the user the full Notion link to the "SRED Project Summary" document for the project and ask them to review it before continuing. Make any changes they ask for.

Step 4 Each project will have one or more Uncertainties. An Uncertainty is defined by the questions:

• What was a challenge or problem we did not have the answer to?
• Is there prior art that we could use to base our problem solving on?
• If not, why?

Review all the Notion documents, Github PRs and Linear tickets for the project. Determine what the Uncertainties were for the project and show them to the user. Ask the user whether these are correct or should be adjusted in some way.