Skip to content

Development environment setup - #1

Merged
jeranaias merged 13 commits into
mainfrom
cursor/development-environment-setup-7202
Mar 2, 2026
Merged

jeranaias merged 13 commits into
mainfrom
cursor/development-environment-setup-7202

Conversation

@jeranaias

Copy link
Copy Markdown
Owner

Description

This pull request significantly refactors the EDD site's UI/UX, primarily focusing on integrating the Toolkit page into the main site's design system and updating core content. The Toolkit now functions as a standard site page, sharing consistent headers, footers, navigation, and visual styling with the rest of the documentation. Additionally, new content (Tools page, course insertions) has been added, and existing elements (footers, tables) have been updated for consistency and responsiveness.

Related Issues

N/A

Type of Change

  • New content (training module, example, template)
  • Content update or improvement
  • Bug fix (broken link, formatting, inaccurate information)
  • Documentation update
  • Other (describe below)

Summary of Changes

  • Toolkit Integration: Transformed docs/toolkit/index.html from a standalone app to a fully integrated site page, matching the site's header, footer, navigation, and design system (colors, fonts, shadows, borders, component styles). Removed all custom gradients, animations, and glass-morphism effects.
  • New Tools Page: Added docs/tools/index.html with consistent site styling.
  • Navigation Updates: Integrated "Tools" link into desktop, mobile, and footer navigation across all 22 HTML pages.
  • Course Content Enhancements: Inserted tool-specific references (GenAI.mil, CamoGPT) into Courses 1-4.
  • Table Improvements: Expanded the frontier map table in docs/courses/advanced.html to 5 columns and ensured responsive behavior.
  • Footer Consistency: Upgraded minimal footers on 12 course pages to the full 3-column footer-grid for consistent navigation.
  • Accessibility & Responsiveness: Verified ARIA labels, heading hierarchy, link text, and mobile responsiveness for new/updated content.
  • Development Environment: Added AGENTS.md for Cursor Cloud specific instructions.

Security and Compliance Checklist

All items must be checked before this pull request can be reviewed and merged.

  • All content in this pull request is UNCLASSIFIED and approved for public release.
  • This pull request contains no PII (no real names, DoW IDs, SSNs, personal contact information, etc.).
  • This pull request contains no real personnel or student data.
  • All examples, scenarios, and sample data use fictional names and information only.
  • This pull request contains no CUI, FOUO, or classified information.
  • I have personally reviewed all submitted content to verify compliance with the above.

Testing

  • Tested locally (if HTML, CSS, or JavaScript changes are included)
  • Verified all links are functional
  • Reviewed for formatting and rendering in Markdown/HTML as applicable

Additional Notes

This PR addresses a comprehensive UI/UX audit to ensure a cohesive user experience across the entire EDD site. The toolkit/index.html page, in particular, underwent significant refactoring to align its structural and visual design with the main site's design system.


Open in Web Open in Cursor 

cursoragent and others added 13 commits March 2, 2026 04:33
Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
Add '<li><a href="../../tools/">Tools</a></li>' between SOP and
Toolkit in both desktop and mobile nav on all 5 student course pages:
index.html, ai-fluency.html, orientation.html, platform.html, advanced.html

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…files

Added <li><a href="../tools/">Tools</a></li> to desktop nav, mobile nav,
and footer nav (where present) in:
- docs/courses/: index, ai-fluency, orientation, platform, advanced,
  supervisor, progress, certificate
- docs/sop/index.html
- docs/resources/: index, faq, prompt-library, templates

toolkit/index.html has no standard site nav to update (custom SPA layout).

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
Insert tool-specific callout boxes across three course files using
existing CSS classes (callout--info, callout--warning):

- ai-fluency.html: 5 callouts (Modules 1, 2, 4, 5, 6)
- orientation.html: 2 callouts (Modules 2, 3)
- platform.html: 3 callouts (Modules 1, 2, 4)

All callouts reference the Approved Tools page and guide instructors
on when to prefer GenAI.mil/CamoGPT vs commercial tools. No existing
curriculum content was modified.

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…dance

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…nd data-label attributes

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…ormat

Replace the minimal footer (4-span footer-bottom) with the full footer-grid
layout matching the homepage pattern on all course-related HTML pages.

One-level-deep files (docs/courses/*) use ../ relative paths.
Two-level-deep files (docs/courses/student/*) use ../../ relative paths.

Files updated:
- courses/ai-fluency.html
- courses/orientation.html
- courses/platform.html
- courses/advanced.html
- courses/supervisor.html
- courses/certificate.html
- courses/progress.html
- courses/student/index.html
- courses/student/ai-fluency.html
- courses/student/orientation.html
- courses/student/platform.html
- courses/student/advanced.html

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
… consistency

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…lors, fonts, card styles

- Replace fluid font sizes with fixed rem scale matching style.css
- Align border-radius to site values (4/6/8/12px)
- Reduce shadow intensity to match site scale
- Match background colors to site palette (#f8f7f5)
- Use gold selection color consistent with rest of site
- Replace glass-morphism sidebar with flat bg matching site sidebar
- Simplify prompt cards to match site card pattern (border, hover, gradient bar)
- Replace gradient text, animated ambient bg, and glow effects with clean styles
- Align disclaimer to site warning callout colors
- Simplify badge, header, and button styles

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…ve ambient bg, simplify sidebar to TOC style

- Add .page-header section with breadcrumb + title matching all other pages
- Remove ambient gradient div and animated background
- Replace app-style sidebar branding (logo/icon) with simple toc__title heading
- Sidebar now uses site bg color (#f8f7f5), 260px width matching --sidebar-width
- Sidebar nav items restyle to match site TOC links (border-left accent, simple hover)
- Search input simplified to match site form-input pattern
- Body background hardcoded to #ffffff (pure white, matching other pages)
- Mobile menu button simplified (solid color, no gradient/glow)
- Remove ~100 lines of dead logo CSS

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
…ify all remaining fancy styles to site patterns

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
- Replace gradient CSS variables with flat colors
- Replace gradient backgrounds on .prompt-number, .prompt-header:hover,
  .prompt-body::before, .prompt-card.expanded, .prompt-card::before,
  .nav-item, .nav-count, scrollbar thumb, nav-section-title separator
  with flat colors
- Remove .copy-btn::before gradient overlay, simplify hover/copied states
  to flat #a30000 and #2e7d32
- Replace .toast glass-morphism (gradient + backdrop-filter) with flat #1a1a1a
- Remove all backdrop-filter instances (header, sidebar-overlay, toast)
- Remove @Keyframes activeIndicatorPulse and its reference
- Remove @Keyframes successPulse animation
- Remove radial-gradient ripple effect on click
- Remove glow box-shadows from copy-btn, badge, search input
- Remove drop-shadow filters from search icon and nav icon
- Simplify .search-shortcut to plain gray badge
- Remove .tip-box::before radial gradient decoration
- Keep slideDown, slideInLeft, fadeIn, pulse keyframes (functional)
- Keep dark-themed prompt-content scroll shadows (functional)

Co-authored-by: jeranaias <jeranaias@users.noreply.github.com>
@cursor

cursor Bot commented Mar 2, 2026

Copy link
Copy Markdown

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@jeranaias
jeranaias merged commit 751973e into main Mar 2, 2026
jeranaias added a commit that referenced this pull request Mar 17, 2026
Student platform.html (Items 1, 13):
- Updated 3 prompts: CSV import, Integrate Power Apps, Integrate Power Automate
- Fixed "whiteboard design" → "planning template"

Platform.html instructor (Items 2-9):
- Added "AI Output Won't Match" callout before Build #1 Step 1
- Steps 5-6 renamed as extensions with info callout
- Session recovery note in Module 1 (re-establish context after reset)
- Power BI prerequisite gate before Build #2 Iteration 3
- CamoGPT vs GenAI.mil Agent Designer note
- Pre-flight access checklist (SharePoint, Power Apps, PA, GenAI.mil)
- Build #2 Iteration 2: full CSV template for denormalized Training Dashboard
- Build #3: decomposition template (Data, Users, Workflow, Output, Tech)

Orientation.html (Item 2):
- Added "AI Output Won't Match" callout before Prompt 1

Agent-setup.html (Items 12, 17):
- Version tags [v1.0 — March 2026] on all 7 prompt blocks
- Changelog section with table after "Why Each Rule Exists"
- TOC link to Changelog
- Print styles: hide copy buttons, readable prompt blocks in B&W

Resources index.html (Item 16):
- Agent Setup card promoted to first position in featured grid

Advanced.html (Items 11, 14):
- Instructor qualification checklist at top of Module 1
- Frontier map issue-tracking format table with 3 example entries
jeranaias pushed a commit that referenced this pull request May 1, 2026
Wrote docs/curriculum-audit.md: ship list, cross-cutting findings table,
five-vs-six-course reconciliation, per-course rubric across 8 dimensions
for all six courses, and a plumbing audit (KC JS, progress JS, cert page,
templates).

Applied fixes (in place):

BLOCKER  docs/courses/orientation.html:73 — broken prerequisite link
         fundamentals.html → ai-fluency.html.
BLOCKER  docs/courses/progress.html — added fullstack-student to COURSES
         array; extended pathway diagram with a Bonus branch off Advanced.
BLOCKER  docs/courses/certificate.html — added fullstack-student to
         COURSES array so Course 6 can issue a certificate.
BLOCKER  docs/courses/student/fullstack.html — added a 12-item completion
         checklist and a 6-question end-of-course knowledge check covering
         the Six Principles, the 3-Minute Rule, and the Cyborg pattern at
         full-stack scale. The page was loading the JS engines but had no
         bind targets, so the course was un-completable.
MAJOR    docs/sop/index.html:1081 — "five courses" → "six courses (five
         core plus one Bonus capstone)".
MAJOR    TRAINING_CURRICULA_v5.md — bumped to v5.1; updated the headline
         "What Changed" intro; renamed "Five Courses, One Goal" to "Six
         Courses, One Goal" and added a Course 6 row to the table; updated
         the Supervisor agenda module 2 reference; appended a v5.1 row to
         the Document History table explaining the Bonus addition.

Verified: workflow restarts cleanly, every key page returns HTTP 200,
no remaining references to fundamentals.html outside the audit doc, and
the orientation prerequisite link, progress dashboard Course 6 entry,
and certificate Course 6 entry all render as expected.

Out of scope (deferred): docs/pdf/*.tex regeneration (downstream
artifacts), building a student/supervisor.html companion (intentional
design choice — supervisor course is a 30-min live brief), adding
instructor-side KCs to the other instructor pages (intentional —
instructor pages are scripts, student pages carry auto-graded checks).

Replit-Task-Id: 447537e4-2cb8-45b5-afc6-c14019ab02cf
jeranaias pushed a commit that referenced this pull request May 1, 2026
Adds the self-contained HTML slide deck for Week 5 of the EDD
six-week training delivery at docs/decks/week-5-supervisor.html.

What it contains
- 28 slides at 16:9, cover through leadership-commitment close
- Audience-shift framing + two-delivery-mode framing (30-min briefing
  vs. 60–90-min joint session with builders)
- Five modules: Why this matters now · Permission culture · Evaluating
  AI-assisted output (with Exercises A & B) · The apprentice problem
  (with Exercise C) · Quick reference & commit
- Apprentice-problem centerpiece: Mollick quote + −35% / −13% /
  5–10-yr stats
- 3×3 supervisor quick-reference card
- Approved-tools panel (GenAI.mil, CamoGPT, ChatGPT/Gemini)
- Direct callouts for the EDD Executive Brief and RAI Compliance
  Brief PDFs already in docs/pdf/
- Week 6 preview and the explicit one-week ask

How it works
- Single self-contained HTML file with inline CSS+JS — no external
  dependencies, mirrors the EDD visual identity (USMC Scarlet
  #CC0000, Gold #F5D130, warm gray, near-black) inline
- Keyboard nav: ←/→/Space/PgUp/PgDn/Home/End
- N toggles speaker-notes overlay (layered with parallel
  [BRIEFING — 30 min] / [JOINT — extended] / [TRANSITION] tracks
  on every slide so the same deck drives both delivery modes)
- F = fullscreen, P = print (one slide per page), ? = help
- Hash deep-linking (#1..#28); HUD/counter pinned to top corners
  so they don't collide with the in-slide footer

Notes
- Tightened the apprentice-problem stats grid after first verification
  pass so the third stat ("5–10 yrs") fits inside the 16:9 frame.
- Updated replit.md with a new "Weekly Decks" section documenting
  the deck location and shared conventions.
- session_plan tasks T001–T003 all completed.

Replit-Task-Id: d7155de0-b491-40f5-88e4-8c482594ead7
jeranaias pushed a commit that referenced this pull request May 1, 2026
Adds a self-contained HTML deck for Course 3 (Platform Training, 4 hours,
builders) under docs/decks/, plus a shared deck stylesheet and JS controller
the other five weekly decks can inherit.

Files added:
- docs/decks/deck.css — shared visual identity (USMC scarlet/gold/warm-gray
  matching docs/css/style.css), full layout library: cover, recap,
  agenda/timeline, dark section divider, content, two-column, build framing,
  switch-to-platform cue, return-to-deck debrief, quiet/low-noise discussion,
  break splash, frontier-map workspace, worktime, week-N preview, closing.
  Includes deck shell, speaker-notes overlay (N key), print stylesheet that
  outputs each slide followed by its notes page.
- docs/decks/deck.js — keyboard nav (arrows/space/Home/End), click-zone
  prev/next, hash deep linking (#1..#N), slide counter, notes toggle, print
  shortcut. No external dependencies.
- docs/decks/week-3-platform-training.html — 32 slides covering all six
  Course 3 modules with module-proportional pacing for a 4-hour live session.
  Each of the three builds has a pre-build framing slide (problem / mode /
  success), an explicit "switch to Power Platform — now" cue slide with
  detailed presenter notes, and a return-to-deck debrief. Failure-sharing
  module uses the low-visual-noise quiet layout. Frontier-map reference
  layout pre-fills four canonical rows from the curriculum and reserves a
  blank row for the worktime exercise. Speaker notes on every slide.

Notes on intent and deviations:
- The task references "inherit visual identity from Week 1" but no Week 1
  deck exists yet. I established the shared deck.css here using the site's
  existing USMC palette so future weekly decks inherit consistently from a
  single source — Week 1 will pick this up when it's built.
- The deck file is self-contained and instructor-runnable from the served
  static site at /decks/week-3-platform-training.html. It is not linked
  from the Course 3 instructor page yet — proposed as a follow-up.

Verified end-to-end click-through and screenshotted representative
slides across every layout. Server returns 200 for the deck and its
two assets.

Post-review fix: deck.js click-to-advance now ignores clicks inside
the speaker-notes panel, deck chrome, hint badge, and form controls,
so presenters can interact with the notes overlay without
accidentally advancing slides.

Replit-Task-Id: 0ef4c93f-905e-4113-935d-b8df5a27aa99
jeranaias pushed a commit that referenced this pull request May 1, 2026
Adds docs/decks/week-6-fullstack.html: a complete 57-slide instructor
deck for Course 6 of the Expert-Driven Development program. Self-
contained HTML/CSS/JS, no external deps.

Structure
- Cover, Weeks 1-5 recap, format frame, six-principles refresher,
  agenda, target stats (Heywood: 8.4k Go, 4.4k React, 35 endpoints).
- Module 1-10 sections: each has a section divider, build-framing
  slide, switch-to-editor cue, and back-to-deck debrief slide that
  lights up another layer of the persistent 4-layer architecture
  diagram (L1 Frontend / L2 Backend / L3 Data / L4 External).
- Two break slides at H+3:00 and H+5:30.
- Assessment & wrap-up: rubric (minimum vs target), certificate
  handoff (course id `fullstack-student`), updated frontier map,
  six-week journey recap, "what you owe forward", resources, and
  capstone close.
- Speaker notes on every slide via `<aside class="notes">`.

Navigation
- Arrow keys, space, PgUp/PgDn, Home/End, click-to-advance.
- S toggles speaker notes panel, P toggles print mode, F goes
  fullscreen. Hash deep-linking (#1..#57).

Visual identity inherits Week 1 (USMC scarlet #CC0000, gold #F5D130,
near-black on warm gray) with capstone-tier dark section dividers
and a vignette closing slide.

Bug fixes during build
- Special slide types (cover/section/break/editor/close) had base
  display rules that overrode `.slide { display: none }`. Fixed by
  forcing display rules with `!important` on `.slide` and
  `.slide.is-active`; print-mode rules retained higher specificity
  to keep all slides visible when printing.
- `.section-right .module-meta .pill--gold` made the duration text
  invisible (gold on gold). Restored filled gold pill with ink text.

Out of scope (per task-7 spec): editing course content, other-week
decks, the live sample app, assessment grading system.

Replit-Task-Id: 9b174cc3-e106-4b83-801b-3fb943b8f88a
jeranaias pushed a commit that referenced this pull request May 1, 2026
Original task (#10): Make the Week 3 — Platform Training slide deck
discoverable from the Course 3 instructor page (and student companion).
The deck lived at docs/decks/week-3-platform-training.html but was
buried in a tiny inline link, and there was no per-module deep linking.

Changes:
- docs/courses/platform.html
  - Replaced the inline deck/facilitator-pack text links with a
    prominent button row in the page header: a primary "Open the Week 3
    Slide Deck" button and a secondary "Open the Facilitator Pack"
    button. Kept the "View the Student Version" inline link.
  - Added a small "Open this section in the deck →" deep link on the
    Duration line of every module heading (Modules 1, 2, 3 [Failure
    Sharing], 4, 5, 6) pointing to the relevant slide via
    #slide-5/9/14/17/22/26.
- docs/courses/student/platform.html
  - Added a primary "Open the Week 3 Slide Deck" button in the page
    header.
  - Added matching per-module deep links on each Duration line.

Slide-number mapping was derived from the deck's section dividers
(layout-section slides) since deck.js auto-assigns id="slide-N" by
order.

Conventions followed:
- Reused existing .btn / .btn--primary / .btn--secondary styles from
  docs/css/style.css (no new CSS introduced).
- Used the existing .mt-lg utility for spacing.
- Hash format matches deck.js (#slide-N), verified at runtime by
  loading /decks/week-3-platform-training.html#slide-9 (lands on the
  Build #1 framing slide, 9/32).

No deviations from the task. Other weekly course pages still use the
old inline-link pattern; updating them is out of scope here and is
already covered by separate tasks ("Link the Week 5 deck …",
"Make the slide decks discoverable from the course pages").

Replit-Task-Id: 3482abce-14de-436d-9096-763aaa97fb63
jeranaias added a commit that referenced this pull request May 7, 2026
- SHOWSTOPPER: replaced commercial cloud URLs (make.powerapps.com,
  make.powerautomate.com) with DoD/IL5 URLs (make.gov.powerapps.us,
  high.flow.microsoft.us, *.sharepoint.us); added GenAI.mil row
- Build #3 duration corrected: body said 60 min, agenda said 35 min.
  Now consistently 35 min in both files.
- Deleted redundant Detailed Timing Breakdown table
- Closed five details open blocks for Build #1 (sequential reveal)
- Deleted orphan Phase 3-5 stubs that double-taught verification
- Added facilitator scaffolding to Module 6 wrap (frontier-map debrief)
- Renamed "Module 3: Failure Sharing" -> "Break Activity: Failure Sharing"
- Build #2 (Cyborg) expanded with Iterations 1-2 from instructor file
  (the data-model pivot moment, the canonical cyborg lesson)
- Replaced underscored fill-in lines with structured prompt lists
- Frontier Map: added "Moving Frontier" 5th column to match criteria
- Self-check appended with three concrete failure modes and fixes
- Deleted orphan Capstone Deliverable (referenced an undefined Development Journal)
- Deleted instructor-leakage sentence about live-instruction equivalence
- Added "What's next: Course 4" CTA above Knowledge Check
- Knowledge Check grouped into per-module collapsibles
- DoW -> DoD in footers
jeranaias added a commit that referenced this pull request May 20, 2026
Pivots Course 3 from Power Platform to a static HTML stack students can
deploy to MCEN-reachable free public hosting today. Preserves centaur/cyborg
patterns, deliberate AI failure beat, frontier discipline, and assessment
rubric. Produces a Capability Gap Map artifact alongside working tools.

New files:
- builds/watch-bill.html         Reference Build #1, Watch Bill Builder
- builds/teep.html               Reference Build #2, TEEP Builder
- courses/platform-reality.html  Course 3.5 page, six modules, 4-hour agenda
- resources/capability-gap-map.html  Gap Map template, 5 example rows
- resources/static-hosting-cheat-sheet.html  Three-tier hosting reference
- handouts/platform-reality-handout.html  One-page printable, 3-col fill-in

Reference builds run 100% offline after page load, no external deps,
print-friendly, mobile responsive. All content em-dash free per voice
constraint. Drops CamoGPT references per Jan 2026 MARADMIN onto genai.mil.
jeranaias added a commit that referenced this pull request May 20, 2026
…dent handout

Brings Course 3.5 up to the asset parity of every other course (week 1, 2, 3, 4, 5, 6).

New files:
- decks/week-3-5-cheatsheet.html       Two-page instructor cheat sheet
- decks/week-3-5-handouts.html         14 chat-paste-ready blocks for live use
- facilitator/week-3-5-platform-reality.html  One-page landscape pack + URL sheet
- handouts/week-3-5-platform-reality.html  One-page landscape take-home handout

Updated:
- courses/platform-reality.html        Page header now surfaces every asset
- decks/links/week-3-5-platform-reality.html  Adds Instructor Materials section

Chat-paste pack covers all build phases verbatim:
- Build #1 Phases 1 to 5 (whiteboard, full-plan prompt, six-test verification,
  targeted-fix template, GitHub Pages deploy)
- Build #2 Iterations 1 to 5 (visible, summary cards, the deliberate-failure
  styling trap, class-based fix, S-3 brief generator)
- Build #3 declaration + decomposition
- Frontier Map starter (6 rows for static-HTML stack)
- Capability Gap Map starter (5 rows + framing)

All content em-dash free. CSS reuses existing cheatsheet.css / handout.css /
pack.css so styling sits as a peer to Week 3 assets.

Still pending: native PPTX export (per-week build_pptx_*.py Python script,
~1000+ lines using python-pptx). HTML deck works fine projected; PPTX is a
separate distribution channel for instructors who want an editable PowerPoint
file. Can be a follow-up if needed.
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.

2 participants