Spaces:

CUNY-Builders
/

course-material

Running

fdaudens Claude Opus 4.6 (1M context) commited on Mar 26

Commit

34db5b5

1 Parent(s): cfd2b42

feat: add course homepage and Codex starter kit

Static Space with index.html for Builders Track (Classes 5 & 6)
and my-assistant/ starter kit for personal AI coding assistants.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Files changed (14) hide show

README.md +17 -8
index.html +227 -0
my-assistant/AGENTS.md +56 -0
my-assistant/context/beat-notes.md +22 -0
my-assistant/context/sources.md +34 -0
my-assistant/context/style-guide.md +20 -0
my-assistant/data/.gitkeep +0 -0
my-assistant/drafts/.gitkeep +0 -0
my-assistant/research/.gitkeep +0 -0
my-assistant/scripts/.gitkeep +0 -0
my-assistant/skills/daily-digest.md +40 -0
my-assistant/skills/interview-prep.md +37 -0
my-assistant/skills/story-pitch.md +48 -0
my-assistant/todo.md +10 -0

README.md CHANGED Viewed

@@ -1,12 +1,21 @@
 ---
-title: Course Material
-emoji: 🏃
-colorFrom: red
-colorTo: gray
-sdk: gradio
-sdk_version: 6.9.0
-app_file: app.py
 pinned: false
 ---
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

 ---
+title: "AI Journalism Lab — Builders Track"
+emoji: "\U0001F4DD"
+colorFrom: blue
+colorTo: purple
+sdk: static
 pinned: false
 ---
+# AI Journalism Lab — Builders Track
+Course materials for the CUNY AI Journalism Lab, Builders Track (Classes 5 & 6).
+## Contents
+- **`index.html`** — Course homepage (served by the Space)
+- **`my-assistant/`** — Starter kit for building a personal AI coding assistant with Codex
+## For Students
+Visit the [Space homepage](https://huggingface.co/spaces/CUNY-Builders/course-material) for links to presentations, resources, and the starter kit.

index.html ADDED Viewed

	@@ -0,0 +1,227 @@

+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AI Journalism Lab — Builders Track</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+      background: #f8f9fb;
+      color: #1a1a2e;
+      line-height: 1.6;
+    }
+    header {
+      background: linear-gradient(135deg, #1a1a2e 0%, #2d2d5e 100%);
+      color: #fff;
+      padding: 3rem 2rem 2.5rem;
+      text-align: center;
+    }
+    header p.label {
+      font-size: 0.8rem;
+      text-transform: uppercase;
+      letter-spacing: 0.15em;
+      color: #a0a0d0;
+      margin-bottom: 0.5rem;
+    }
+    header h1 {
+      font-size: 2rem;
+      font-weight: 700;
+      margin-bottom: 0.5rem;
+    }
+    header .subtitle {
+      font-size: 1.05rem;
+      color: #c0c0e8;
+      max-width: 560px;
+      margin: 0 auto;
+    }
+    main {
+      max-width: 780px;
+      margin: -1.5rem auto 3rem;
+      padding: 0 1.5rem;
+    }
+    .card {
+      background: #fff;
+      border-radius: 12px;
+      box-shadow: 0 1px 3px rgba(0,0,0,0.06), 0 4px 12px rgba(0,0,0,0.04);
+      padding: 2rem;
+      margin-bottom: 1.5rem;
+    }
+    .card h2 {
+      font-size: 1.15rem;
+      font-weight: 650;
+      margin-bottom: 1rem;
+      color: #1a1a2e;
+    }
+    .link-list {
+      list-style: none;
+    }
+    .link-list li {
+      border-bottom: 1px solid #eee;
+      padding: 0.75rem 0;
+    }
+    .link-list li:last-child {
+      border-bottom: none;
+      padding-bottom: 0;
+    }
+    .link-list a {
+      text-decoration: none;
+      color: #3b3b8f;
+      font-weight: 550;
+      display: flex;
+      align-items: baseline;
+      gap: 0.5rem;
+      transition: color 0.15s;
+    }
+    .link-list a:hover {
+      color: #5c5cc8;
+    }
+    .link-list .meta {
+      font-size: 0.85rem;
+      color: #777;
+      font-weight: 400;
+      margin-left: auto;
+      white-space: nowrap;
+    }
+    .link-list .desc {
+      font-size: 0.88rem;
+      color: #555;
+      margin-top: 0.25rem;
+      padding-left: 1.25rem;
+    }
+    .badge {
+      display: inline-block;
+      font-size: 0.7rem;
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+      padding: 0.15em 0.5em;
+      border-radius: 4px;
+      vertical-align: middle;
+    }
+    .badge.new { background: #e8f5e9; color: #2e7d32; }
+    .badge.upcoming { background: #fff3e0; color: #e65100; }
+    .starter-kit {
+      background: linear-gradient(135deg, #f0f0ff 0%, #e8ecff 100%);
+      border: 1px solid #d0d4f0;
+    }
+    .starter-kit h2 { color: #2d2d5e; }
+    .starter-kit .dl-btn {
+      display: inline-block;
+      margin-top: 1rem;
+      padding: 0.65rem 1.4rem;
+      background: #2d2d5e;
+      color: #fff;
+      border-radius: 8px;
+      text-decoration: none;
+      font-weight: 600;
+      font-size: 0.92rem;
+      transition: background 0.15s;
+    }
+    .starter-kit .dl-btn:hover {
+      background: #3b3b8f;
+    }
+    footer {
+      text-align: center;
+      padding: 1.5rem;
+      font-size: 0.82rem;
+      color: #999;
+    }
+    footer a { color: #777; }
+    @media (max-width: 600px) {
+      header { padding: 2rem 1.2rem 1.8rem; }
+      header h1 { font-size: 1.5rem; }
+      main { padding: 0 1rem; }
+      .card { padding: 1.4rem; }
+      .link-list a { flex-wrap: wrap; }
+      .link-list .meta { margin-left: 1.25rem; margin-top: 0.1rem; }
+    }
+  </style>
+</head>
+<body>
+<header>
+  <p class="label">CUNY AI Journalism Lab</p>
+  <h1>Builders Track</h1>
+  <p class="subtitle">Course materials, presentations, and starter files for building AI-powered journalism tools.</p>
+</header>
+<main>
+  <!-- Starter Kit -->
+  <div class="card starter-kit">
+    <h2>My Assistant — Starter Kit</h2>
+    <p>A ready-to-use workspace template for building your personal AI coding assistant with Codex. Includes custom instructions, context files, and reusable skills.</p>
+    <a class="dl-btn" href="my-assistant/">Browse starter kit</a>
+  </div>
+  <!-- Presentations -->
+  <div class="card">
+    <h2>Presentations</h2>
+    <ul class="link-list">
+      <li>
+        <a href="#">
+          Class 5 — Your AI Coding Assistant
+          <span class="meta">Mar 26 <span class="badge upcoming">upcoming</span></span>
+        </a>
+        <p class="desc">Setup, AGENTS.md, context files, building your first skill</p>
+      </li>
+      <li>
+        <a href="#">
+          Class 6 — Build, Code &amp; Ship
+          <span class="meta">Apr 9 <span class="badge upcoming">upcoming</span></span>
+        </a>
+        <p class="desc">Codex deep dive, code building, MCP, from prototype to daily driver</p>
+      </li>
+    </ul>
+  </div>
+  <!-- Resources -->
+  <div class="card">
+    <h2>Resources</h2>
+    <ul class="link-list">
+      <li>
+        <a href="https://openai.com/index/introducing-codex/">Codex Documentation</a>
+      </li>
+      <li>
+        <a href="https://modelcontextprotocol.io/directory">MCP Servers Directory</a>
+      </li>
+      <li>
+        <a href="https://code.visualstudio.com/">VS Code Download</a>
+      </li>
+    </ul>
+  </div>
+</main>
+<footer>
+  <p>Instructor: Florent Daudens &middot; <a href="https://huggingface.co/spaces/CUNY-Builders/course-material">View on Hugging Face</a></p>
+</footer>
+</body>
+</html>

my-assistant/AGENTS.md ADDED Viewed

	@@ -0,0 +1,56 @@

+# My Assistant
+## Who I am
+I'm [YOUR NAME], a [reporter / editor / data journalist / producer] at [YOUR ORGANIZATION].
+## My beat
+- I cover [YOUR BEAT — e.g., politics, criminal justice, healthcare, technology, housing]
+- Current focus: [what you're actively investigating or tracking]
+## How I work
+- I verify everything before publishing — accuracy is non-negotiable
+- I work with data: spreadsheets, databases, public records, court documents
+- I think in terms of: what's the evidence? what's the public interest? what's the story?
+## What I need help with
+- **Research synthesis**: summarize documents, find patterns across sources, flag gaps
+- **Data analysis**: explore datasets, identify outliers, suggest visualizations
+- **Interview prep**: brainstorm questions based on background material
+- **Daily briefing**: scan sources for relevant developments
+- **Story development**: find angles, identify missing context, stress-test arguments
+- **Writing support**: help me think, don't replace my writing
+## Privacy and confidentiality
+**NEVER share with AI:**
+- Names or identifying details of confidential sources
+- Unpublished investigation details
+- Whistleblower communications
+- Embargoed information
+**When working with sensitive material:**
+- Replace real names with placeholders: [Source A], [Source B]
+- Remove identifying details before analysis
+- Ask me before accessing files in `research/` that are marked sensitive
+## What you should NOT do
+- Never fabricate quotes, statistics, or sources
+- Never assume access to material I haven't shared
+- Always flag when you're uncertain or speculating
+- Don't write in my voice unless I explicitly ask — help me think, don't replace my writing
+## My workspace
+- `context/` — beat notes, source list, style guide
+- `skills/` — reusable workflows (interview prep, daily digest, etc.)
+- `data/` — datasets, CSVs, spreadsheets
+- `research/` — background material, reports, documents
+- `scripts/` — Python scripts, notebooks
+- `drafts/` — work in progress
+When I ask for help, check my `context/` folder first to understand what I'm working on.

my-assistant/context/beat-notes.md ADDED Viewed

	@@ -0,0 +1,22 @@

+# Beat Notes — [Your Beat]
+## Key themes I'm tracking
+- [Theme 1 — e.g., rising housing costs in NYC boroughs]
+- [Theme 2 — e.g., NYPD use-of-force data transparency]
+- [Theme 3 — e.g., migrant shelter policy changes]
+## Open questions
+- [Question I'm trying to answer — e.g., How does the new zoning proposal affect affordable housing targets?]
+- [Angle I haven't explored yet — e.g., Which neighborhoods saw the biggest rent increases since 2023?]
+## Recent developments
+- [Date]: [What happened and why it matters]
+- [Date]: [What happened and why it matters]
+## Key people and organizations
+- [Person/org]: [Why they matter for your beat]
+- [Person/org]: [Why they matter for your beat]

my-assistant/context/sources.md ADDED Viewed

	@@ -0,0 +1,34 @@

+# Sources
+## Primary sources
+| Name | Role / Organization | Expertise | Notes |
+|------|---------------------|-----------|-------|
+| [Name] | [Role] | [Area] | [Last spoke: date, context] |
+## Organizations to watch
+- [Org 1]: [Why they matter for your beat]
+- [Org 2]: [Why they matter for your beat]
+## Daily feeds and websites
+### News
+- [URL] — [What it covers and why you follow it]
+- [URL] — [What it covers and why you follow it]
+### Beat-specific
+- [URL] — [What it covers and why you follow it]
+- [URL] — [What it covers and why you follow it]
+### Data sources
+- [URL] — [What data is available and how you use it]
+- [URL] — [What data is available and how you use it]
+### Social accounts to watch
+- [Platform — handle] — [Why you follow them]
+- [Platform — handle] — [Why you follow them]

my-assistant/context/style-guide.md ADDED Viewed

	@@ -0,0 +1,20 @@

+# Style Guide
+## Language and tone
+- Default language: English
+- Follow [YOUR ORG]'s editorial standards
+- [AP style / Chicago style / house style]
+## Conventions
+- [Spelling preferences — e.g., "healthcare" vs "health care"]
+- [Title conventions — e.g., capitalize formal titles before names]
+- [Number rules — e.g., spell out one through nine]
+- [Attribution style — e.g., "said" not "stated"]
+## Formatting
+- [Preferred date format — e.g., March 26, 2026]
+- [How to handle quotes]
+- [How to cite data sources]

my-assistant/data/.gitkeep ADDED Viewed

File without changes

my-assistant/drafts/.gitkeep ADDED Viewed

File without changes

my-assistant/research/.gitkeep ADDED Viewed

File without changes

my-assistant/scripts/.gitkeep ADDED Viewed

File without changes

my-assistant/skills/daily-digest.md ADDED Viewed

	@@ -0,0 +1,40 @@

+# Daily Digest
+When I ask for a daily digest, morning briefing, or beat scan, follow these steps:
+1. Read `context/beat-notes.md` and extract current themes and open questions
+2. Read `context/sources.md` and scan each listed feed or site for new items
+3. Check `research/` for newly added material that may shift priorities
+4. Select the 8-10 most relevant items and rank by editorial value
+5. Draft a concise morning briefing with links and suggested story angles
+## Output format
+Save to `drafts/daily-digest-YYYY-MM-DD.md`:
+**Theme of the day**
+[1 sentence on the dominant theme]
+**Top items**
+1. **[Headline]**
+   - Source: [Publication/author]
+   - Why it matters: [1 sentence]
+   - Summary: [2 sentences]
+   - Link: [URL]
+[... up to 8-10 items]
+**Story angles**
+- [Angle 1 — what to pursue and why]
+- [Angle 2 — what to pursue and why]
+**Sources checked**
+- [List every feed/site/calendar checked]
+## Rules
+- Do not fabricate facts, quotes, or links
+- If a source cannot be accessed, state that clearly in "Sources checked"
+- Prioritize items that are: (1) timely, (2) relevant to tracked themes, (3) actionable for reporting
+- Include national or international developments only if directly relevant to the beat

my-assistant/skills/interview-prep.md ADDED Viewed

	@@ -0,0 +1,37 @@

+# Interview Prep
+When I ask you to prepare for an interview, follow these steps:
+1. Read my beat notes in `context/beat-notes.md`
+2. Research the person or organization I'm interviewing
+3. Find their recent public statements, articles, social media posts
+4. Identify 3 key themes or tensions to explore
+5. Draft 10 questions, organized by theme
+6. Flag any claims that need verification
+7. Note any connections to my current projects
+## Output format
+**Bio** (3-4 lines)
+**Key themes**
+- Theme with brief context for each
+**Questions** (grouped by theme, ordered easy to hard)
+- Opening questions (rapport-building)
+- Core questions (the meat of the interview)
+- Tough questions (accountability, contradictions)
+- Closing questions (forward-looking, anything they want to add)
+**Suggested follow-ups**
+- If they say X, ask Y
+**Background links**
+- Relevant articles, data, documents
+## Rules
+- Never fabricate quotes or attribute statements without a source
+- Flag when information is unverified or based on limited sources
+- Prioritize questions that serve the public interest
+- Include at least one question I probably haven't thought of

my-assistant/skills/story-pitch.md ADDED Viewed

	@@ -0,0 +1,48 @@

+# Story Pitch Generator
+When I ask you to help me develop a story pitch, follow these steps:
+1. Read `context/beat-notes.md` for current themes and open questions
+2. If I give you a topic or tip, research what's already been published on it
+3. Identify what's new, what's missing from existing coverage, and why it matters now
+4. Draft a structured pitch
+## Output format
+**Headline** (working title)
+**The story in one sentence**
+[What happened + why it matters + who's affected]
+**Why now?**
+[The news peg or timing hook]
+**What we know**
+- [Key fact 1 with source]
+- [Key fact 2 with source]
+- [Key fact 3 with source]
+**What we don't know (and need to find out)**
+- [Open question 1]
+- [Open question 2]
+**Key sources to contact**
+- [Person/org] — [Why they matter] — [How to reach them if public]
+**Data and documents**
+- [What public records or datasets could support this story]
+**Comparable coverage**
+- [What other outlets have done on this — links]
+- [What angle hasn't been covered yet]
+**Scope and format**
+- Estimated reporting time: [quick hit / 1-week / longer investigation]
+- Suggested format: [text / data viz / interactive / video / podcast]
+## Rules
+- Every fact must have a source — flag anything unverified
+- Focus on public interest and impact
+- Be honest about what's strong and what's thin
+- Suggest the strongest version of the story, not the easiest

my-assistant/todo.md ADDED Viewed

	@@ -0,0 +1,10 @@

+# To Do
+## This week
+- [ ] Fill in AGENTS.md with my info
+- [ ] Add my beat notes to context/beat-notes.md
+- [ ] List my key sources and feeds in context/sources.md
+- [ ] Test: ask Codex to read my AGENTS.md and summarize what it knows about me
+- [ ] Test: run the interview prep skill on a real interview
+- [ ] Build one custom skill for a task I do regularly