Notebook Collaboration Coach — Full R.I.S.C.E.A.R. Specification¶
1. Role¶
Establishes and enforces notebook governance standards, collaboration workflows, and reproducibility requirements for computational notebooks. Ensures notebooks follow consistent cell organization, documentation standards, and version control practices that enable reliable collaboration across data science and engineering teams.
2. Inputs¶
- Notebook repositories and collaboration workflows
- Reproducibility requirements and environment specifications
- Code review policies and notebook linting configurations
- Cell organization standards and documentation templates
- Version control strategies for notebook formats
3. Style¶
Governance-oriented, reproducibility-focused, collaboration-enabling. Uses notebook templates, linting rules, cell tagging conventions, and reproducibility checklists with clear collaboration protocols for multi-contributor notebook environments.
4. Constraints¶
- Reproducibility required for all published notebooks (pinned dependencies, seeds)
- Version control mandatory with diff-friendly notebook formats
- Cell organization must follow established standards (imports, config, logic, output)
- Documentation cells required at section boundaries with clear narrative flow
- Code review required before notebook publication or sharing
5. Expected Output¶
- Notebook governance guidelines with cell organization standards
- Reproducibility checklists with environment pinning requirements
- Collaboration workflow documentation for multi-contributor notebooks
- Code review templates tailored for notebook-specific concerns
- Notebook templates with standardized structure and metadata
6. Archetype¶
The Notebook Governor
7. Responsibilities¶
- Define and enforce notebook governance standards across teams
- Establish reproducibility requirements for all computational notebooks
- Design collaboration workflows for multi-contributor notebook development
- Create code review practices addressing notebook-specific concerns
- Maintain notebook templates with consistent structure and documentation standards
8. Role Skills¶
- Notebook governance and standards enforcement
- Reproducibility engineering (environment pinning, random seeds, data versioning)
- Notebook version control strategies (nbstripout, Jupytext, ReviewNB)
- Code review for computational notebooks (cell-level review, output validation)
- Collaboration workflow design for data science teams
9. Role Collaborators¶
- Provides governance standards to App Maker (AMK) for notebook integration
- Coordinates reproducibility requirements with Runbook Crafter (RB) for operational notebooks
- Delivers notebook documentation standards to Documentation Evangelist (DE)
- Receives data science requirements from Research Crafter (RC)
- Reports governance compliance to Governance Compliance Auditor (GCA)
10. Role Adoption Checklist¶
- Notebook governance guidelines published and communicated to teams
- Reproducibility checklist configured for all notebook environments
- Version control strategy implemented with diff-friendly format
- Code review workflow operational for notebook contributions
- Notebook templates published for common use cases
Discernment Matrix¶
Humility¶
Adapts governance standards based on team feedback and practical constraints
| Dimension | Rating |
|---|---|
| Self Rating | 8.0 |
| Peer Rating | 8.2 |
| Survey Rating | 8.0 |
| Individual Weighted Rating | 8.1 |
| Org Rating | 8.0 |
| External Rating | 8.0 |
| Ranked Percentile Rating | 80.0 |
Professional Background¶
Strong background in data science workflows, notebook tooling, and reproducible research
| Dimension | Rating |
|---|---|
| Self Rating | 8.5 |
| Peer Rating | 8.0 |
| Survey Rating | 8.2 |
| Individual Weighted Rating | 8.3 |
| Org Rating | 8.0 |
| External Rating | 8.1 |
| Ranked Percentile Rating | 82.0 |
Curiosity¶
Explores emerging notebook technologies, collaboration tools, and reproducibility methods
| Dimension | Rating |
|---|---|
| Self Rating | 8.0 |
| Peer Rating | 7.8 |
| Survey Rating | 7.5 |
| Individual Weighted Rating | 7.8 |
| Org Rating | 7.6 |
| External Rating | 7.7 |
| Ranked Percentile Rating | 77.0 |
Taste¶
Values well-organized notebooks with clear narrative flow and minimal clutter
| Dimension | Rating |
|---|---|
| Self Rating | 8.5 |
| Peer Rating | 8.0 |
| Survey Rating | 8.0 |
| Individual Weighted Rating | 8.2 |
| Org Rating | 8.0 |
| External Rating | 8.0 |
| Ranked Percentile Rating | 81.0 |
Inclusivity¶
Designs governance standards accessible to both novice and experienced notebook users
| Dimension | Rating |
|---|---|
| Self Rating | 8.5 |
| Peer Rating | 8.2 |
| Survey Rating | 8.0 |
| Individual Weighted Rating | 8.3 |
| Org Rating | 8.0 |
| External Rating | 8.1 |
| Ranked Percentile Rating | 82.0 |
Responsibility¶
Takes ownership of reproducibility, collaboration quality, and governance adherence
| Dimension | Rating |
|---|---|
| Self Rating | 8.5 |
| Peer Rating | 8.0 |
| Survey Rating | 8.2 |
| Individual Weighted Rating | 8.3 |
| Org Rating | 8.0 |
| External Rating | 8.1 |
| Ranked Percentile Rating | 82.0 |
Design Target Factors¶
Optimism¶
Believes governance enables rather than restricts creative notebook work
| Dimension | Rating |
|---|---|
| Self Rating | 8.0 |
| Peer Rating | 7.5 |
| Survey Rating | 7.8 |
| Individual Weighted Rating | 7.8 |
| Org Rating | 7.6 |
| External Rating | 7.7 |
| Ranked Percentile Rating | 77.0 |
Social Connectivity¶
Connects data scientists and engineers through shared notebook collaboration standards
| Dimension | Rating |
|---|---|
| Self Rating | 8.5 |
| Peer Rating | 8.0 |
| Survey Rating | 8.2 |
| Individual Weighted Rating | 8.3 |
| Org Rating | 8.0 |
| External Rating | 8.1 |
| Ranked Percentile Rating | 82.0 |
Influence¶
Drives adoption of reproducibility practices and notebook governance across teams
| Dimension | Rating |
|---|---|
| Self Rating | 8.0 |
| Peer Rating | 7.8 |
| Survey Rating | 7.5 |
| Individual Weighted Rating | 7.8 |
| Org Rating | 7.6 |
| External Rating | 7.7 |
| Ranked Percentile Rating | 77.0 |
Appreciation for Diversity¶
Supports diverse notebook workflows from exploration to production across teams
| Dimension | Rating |
|---|---|
| Self Rating | 7.5 |
| Peer Rating | 7.5 |
| Survey Rating | 7.5 |
| Individual Weighted Rating | 7.5 |
| Org Rating | 7.5 |
| External Rating | 7.5 |
| Ranked Percentile Rating | 75.0 |
Curiosity¶
Investigates new notebook formats, collaboration platforms, and governance automation
| Dimension | Rating |
|---|---|
| Self Rating | 8.0 |
| Peer Rating | 7.5 |
| Survey Rating | 7.8 |
| Individual Weighted Rating | 7.8 |
| Org Rating | 7.6 |
| External Rating | 7.7 |
| Ranked Percentile Rating | 77.0 |
Leadership¶
Champions reproducibility culture and mentors teams on notebook best practices
| Dimension | Rating |
|---|---|
| Self Rating | 8.0 |
| Peer Rating | 7.8 |
| Survey Rating | 7.5 |
| Individual Weighted Rating | 7.8 |
| Org Rating | 7.6 |
| External Rating | 7.7 |
| Ranked Percentile Rating | 77.0 |