Skip to content

Split analysis/ by dataset, then by topic - #17

Merged
Marius1311 merged 2 commits into
mainfrom
docs/dataset-topic-layout
Oct 21, 2026
Merged

Marius1311 merged 2 commits into
mainfrom
docs/dataset-topic-layout

Conversation

@Marius1311

Copy link
Copy Markdown
Member

analysis/ is now split by dataset, then by broad topic: analysis/<dataset>/<topic>/, with the dataset level even in a repo with one dataset. Topics such as preprocessing/, annotation/ or spatial/ can mostly be worked on in any order. Notebooks sit flat under a topic and write figures to figures/<dataset>/<topic>/; task directories sit under a topic too.

The skill's "Two lanes" states the layout; the session-start rule, the README and the layout guard's docstring show the new task path. The guard itself is unchanged: it only requires a task directory's name to end in _vN. Version 0.5.0.

The analysis template's review guide and .gitignore comment follow in quadbio/analysis_template.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-21T09:34:53.975707Z 052459e PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 052459ee89

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


Humans work in notebooks, flat under `analysis/<topic>/`, writing to `data/<dataset>/results/` and
`figures/<topic>/`; notebook outputs are committed. Agents work in task directories, with scripts.
`analysis/` is split by dataset, then by broad topic: `analysis/<dataset>/<topic>/`, with the dataset level even when

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Align the task template with the new hierarchy

When a task consumes another task's output under this newly required dataset/topic hierarchy, the copied template still instructs authors at skills/analysis-workflow/assets/task_template/README.md:26 to record analysis/<other_task>/outputs/<file>. That omits the dataset and topic components, so following the template produces a non-existent input path and makes the task README's rerun instructions incorrect; update the template example to include both levels.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Fixed in f878e0d: the example is now analysis/<dataset>/<topic>/<other_task>/outputs/<file>. It was the only remaining path without both levels.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Marius1311
Marius1311 merged commit b914656 into main Oct 21, 2026
3 checks passed
@Marius1311
Marius1311 deleted the docs/dataset-topic-layout branch October 21, 2026 09:52
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