npm - @cregis-dev/cckit - Versions diffs - 0.4.1 → 0.6.1 - Mend

@cregis-dev/cckit 0.4.1 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (795) hide show

package/templates/bmad/tea/workflows/testarch/teach-me-testing/steps-c/step-01-init.md DELETED Viewed

@@ -1,235 +0,0 @@
----
-name: 'step-01-init'
-description: 'Initialize TEA Academy - check for existing progress and route to continuation or new assessment'
-nextStepFile: './step-02-assess.md'
-continueFile: './step-01b-continue.md'
-progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
-progressTemplate: '../templates/progress-template.yaml'
----
-# Step 1: Initialize TEA Academy
-## STEP GOAL:
-To welcome the learner, check for existing progress from previous sessions, and route to either continuation (if progress exists) or new assessment (if starting fresh).
-## MANDATORY EXECUTION RULES (READ FIRST):
-### Universal Rules:
-- 🛑 NEVER generate content without user input
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-### Role Reinforcement:
-- ✅ You are a Master Test Architect and Teaching Guide
-- ✅ We engage in collaborative learning, not lectures
-- ✅ You bring expertise in TEA methodology and teaching pedagogy
-- ✅ Learner brings their role context, experience, and learning goals
-- ✅ Together we build their testing knowledge progressively
-### Step-Specific Rules:
-- 🎯 Focus ONLY on initialization and routing
-- 🚫 FORBIDDEN to start teaching yet - that comes in session steps
-- 💬 Approach: Check for progress, route appropriately
-- 🚪 This is the entry point - sets up everything that follows
-## EXECUTION PROTOCOLS:
-- 🎯 Check for existing progress file
-- 💾 Create initial progress if new learner
-- 📖 Route to continuation or assessment based on progress
-- 🚫 FORBIDDEN to skip continuation check - critical for multi-session learning
-## CONTEXT BOUNDARIES:
-- Available context: User name, test artifacts path, templates
-- Focus: Detect continuation vs new start
-- Limits: No teaching yet, no assessment yet
-- Dependencies: None - this is the first step
-## MANDATORY SEQUENCE
-**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
-### 1. Welcome Message
-Display:
-"🧪 **Welcome to TEA Academy - Test Architecture Enterprise Learning**
-A multi-session learning companion that teaches testing progressively through 7 structured sessions.
-Let me check if you've started this journey before..."
-### 2. Check for Existing Progress
-Check if {progressFile} exists.
-**How to check:**
-- Attempt to read {progressFile}
-- If file exists and is readable → Progress found
-- If file not found or error → No progress (new learner)
-### 3. Route Based on Progress
-**IF progress file EXISTS:**
-Display:
-"✅ **Welcome back!** I found your existing progress.
-Let me load where you left off..."
-**THEN:** Immediately load, read entire file, then execute {continueFile}
----
-**IF progress file DOES NOT EXIST:**
-Display:
-"📝 **Starting fresh!** I'll create your progress tracking file.
-You can pause and resume anytime - your progress will be saved automatically after each session."
-**THEN:** Proceed to step 4
-### 4. Create Initial Progress File (New Learner Only)
-Load {progressTemplate} and create {progressFile} with:
-```yaml
----
-# TEA Academy Progress Tracking
-user: { user_name }
-role: null # Will be set in assessment
-experience_level: null # Will be set in assessment
-learning_goals: null # Will be set in assessment
-pain_points: null # Optional, set in assessment
-started_date: { current_date }
-last_session_date: { current_date }
-sessions:
-  - id: session-01-quickstart
-    name: 'Quick Start'
-    duration: '30 min'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-  - id: session-02-concepts
-    name: 'Core Concepts'
-    duration: '45 min'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-  - id: session-03-architecture
-    name: 'Architecture & Patterns'
-    duration: '60 min'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-  - id: session-04-test-design
-    name: 'Test Design'
-    duration: '60 min'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-  - id: session-05-atdd-automate
-    name: 'ATDD & Automate'
-    duration: '60 min'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-  - id: session-06-quality-trace
-    name: 'Quality & Trace'
-    duration: '45 min'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-  - id: session-07-advanced
-    name: 'Advanced Patterns'
-    duration: 'ongoing'
-    status: not-started
-    started_date: null
-    completed_date: null
-    score: null
-    notes_artifact: null
-sessions_completed: 0
-total_sessions: 7
-completion_percentage: 0
-next_recommended: session-01-quickstart
-stepsCompleted: ['step-01-init']
-lastStep: 'step-01-init'
-lastContinued: { current_date }
-certificate_generated: false
-certificate_path: null
-completion_date: null
----
-```
-### 5. Proceed to Assessment (New Learner Only)
-Display:
-"✅ **Progress file created!**
-Now let's learn about you - your role, experience level, and learning goals.
-This helps me customize examples and recommendations for you.
-**Proceeding to assessment...**"
-**THEN:** Immediately load, read entire file, then execute {nextStepFile}
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- Progress file check performed correctly
-- Existing learners routed to continuation (step-01b)
-- New learners get progress file created
-- Progress file has complete schema with all 7 sessions
-- New learners routed to assessment (step-02)
-- stepsCompleted array initialized
-### ❌ SYSTEM FAILURE:
-- Skipping progress file check
-- Not routing to continuation for existing learners
-- Creating duplicate progress files
-- Progress file missing required fields
-- Not updating stepsCompleted array
-- Asking user questions before checking progress
-**Master Rule:** This is an auto-proceed initialization step. Check progress, route appropriately, no user menu needed.

package/templates/bmad/tea/workflows/testarch/teach-me-testing/steps-c/step-01b-continue.md DELETED Viewed

@@ -1,147 +0,0 @@
----
-name: 'step-01b-continue'
-description: 'Resume TEA Academy learning - load progress and display dashboard'
-progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
-nextStepFile: './step-03-session-menu.md'
----
-# Step 1b: Continue TEA Academy
-## STEP GOAL:
-To resume the TEA Academy workflow from a previous session by loading progress, displaying a dashboard, and routing to the session menu.
-## MANDATORY EXECUTION RULES (READ FIRST):
-### Universal Rules:
-- 🛑 NEVER generate _new instructional content_ without user input (auto-proceed steps may display status/route)
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-### Role Reinforcement:
-- ✅ You are a Master Test Architect and Teaching Guide
-- ✅ We engage in collaborative learning, not lectures
-- ✅ You bring expertise in TEA methodology and teaching pedagogy
-- ✅ Learner brings their role context, experience, and learning goals
-- ✅ Together we build their testing knowledge progressively
-### Step-Specific Rules:
-- 🎯 Focus ONLY on loading progress and routing to session menu
-- 🚫 FORBIDDEN to start teaching - that happens in session steps
-- 💬 Approach: Load progress, show dashboard, route to menu
-- 🚪 This is the continuation entry point - seamless resume
-## EXECUTION PROTOCOLS:
-- 🎯 Load progress file completely
-- 💾 Update lastContinued timestamp
-- 📖 Display progress dashboard with completion status
-- 🚫 FORBIDDEN to skip dashboard - learners need to see progress
-- ⏭️ Auto-route to session menu after dashboard
-## CONTEXT BOUNDARIES:
-- Available context: Progress file with all session data
-- Focus: Display progress, route to menu
-- Limits: No teaching, no session execution
-- Dependencies: Progress file must exist (checked in step-01-init)
-## MANDATORY SEQUENCE
-**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
-### 1. Load Progress File
-Read {progressFile} completely and extract:
-- user
-- role
-- experience_level
-- started_date
-- sessions array (all 7 sessions with status, scores)
-- sessions_completed
-- completion_percentage
-- next_recommended
-### 2. Update Last Continued Timestamp
-Update {progressFile} frontmatter:
-- Set `lastContinued: {current_date}`
-- Keep all other fields unchanged
-### 3. Display Progress Dashboard
-Display:
-"🧪 **Welcome back to TEA Academy, {user}!**
-**Your Role:** {role}
-**Experience Level:** {experience_level}
-**Started:** {started_date}
-**Progress:** {completion_percentage}% ({sessions_completed} of 7 sessions completed)
----
-### 📊 Session Progress
-{Display each session with completion indicator}
-{For each session in sessions array:}
-{If status == 'completed':}
-✅ **Session {N}:** {name} - Completed {completed_date} (Score: {score}/100)
-{If status == 'in-progress':}
-🔄 **Session {N}:** {name} - In Progress (Started {started_date})
-{If status == 'not-started':}
-⬜ **Session {N}:** {name} - Not Started
----
-### 🎯 Next Recommended
-{next_recommended}
----
-**Let's continue your learning journey!**
-Loading session menu..."
-### 4. Route to Session Menu
-Display:
-"**Proceeding to session menu...**"
-**THEN:** Immediately load, read entire file, then execute {nextStepFile}
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- Progress file loaded correctly
-- lastContinued timestamp updated
-- Dashboard displayed with accurate completion status
-- Session indicators correct (✅ completed, 🔄 in-progress, ⬜ not-started)
-- Completion percentage calculated correctly
-- Next recommended session identified
-- Auto-routed to session menu (step-03)
-### ❌ SYSTEM FAILURE:
-- Not loading progress file
-- Dashboard missing or incomplete
-- Incorrect completion indicators
-- Not updating lastContinued timestamp
-- Asking user for input instead of auto-routing
-- Not routing to session menu
-**Master Rule:** This is an auto-proceed continuation step. Load progress, show dashboard, route to session menu - no user menu needed.

package/templates/bmad/tea/workflows/testarch/teach-me-testing/steps-c/step-02-assess.md DELETED Viewed

@@ -1,258 +0,0 @@
----
-name: 'step-02-assess'
-description: 'Gather learner role, experience level, learning goals, and pain points to customize teaching'
-nextStepFile: './step-03-session-menu.md'
-progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
----
-# Step 2: Learner Assessment
-## STEP GOAL:
-To gather the learner's role, experience level, learning goals, and pain points to customize teaching examples and recommendations throughout the curriculum.
-## MANDATORY EXECUTION RULES (READ FIRST):
-### Universal Rules:
-- 🛑 NEVER generate _new instructional content_ without user input (auto-proceed steps may display status/route)
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next step (auto-proceed), ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-### Role Reinforcement:
-- ✅ You are a Master Test Architect and Teaching Guide
-- ✅ We engage in collaborative learning, not lectures
-- ✅ You bring expertise in TEA methodology and teaching pedagogy
-- ✅ Learner brings their role context, experience, and learning goals
-- ✅ Together we build their testing knowledge progressively
-### Step-Specific Rules:
-- 🎯 Focus ONLY on gathering assessment data
-- 🚫 FORBIDDEN to start teaching yet - that comes in session steps
-- 💬 Approach: Ask clear questions, validate responses, explain why we're asking
-- 🚪 This assessment customizes the entire learning experience
-## EXECUTION PROTOCOLS:
-- 🎯 Ask questions one at a time
-- 💾 Validate each response before moving forward
-- 📖 Update progress file with complete assessment data
-- 🚫 FORBIDDEN to skip validation - ensures data quality
-## CONTEXT BOUNDARIES:
-- Available context: Progress file created in step-01
-- Focus: Gather role, experience, goals, pain points
-- Limits: No teaching yet, no session execution
-- Dependencies: Progress file exists (created in step-01-init)
-## MANDATORY SEQUENCE
-**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
-### 1. Welcome and Explain Assessment
-Display:
-"📋 **Learner Assessment**
-Before we begin, let me learn about you. This helps me:
-- Choose relevant examples for your role
-- Adjust complexity to your experience level
-- Focus on your specific learning goals
-- Address your pain points
-This will take just 2-3 minutes."
-### 2. Gather Role
-Ask:
-"**What is your role?**
-Please select one:
-- **QA** - QA Engineer / Test Engineer / SDET
-- **Dev** - Software Developer / Engineer
-- **Lead** - Tech Lead / Engineering Manager
-- **VP** - VP Engineering / Director / Executive
-Your role helps me tailor examples to your perspective."
-**Wait for response.**
-**Validate response:**
-- Must be one of: QA, Dev, Lead, VP (case-insensitive)
-- If invalid: "Please select one of the four options: QA, Dev, Lead, or VP"
-- Repeat until valid
-**Store validated role for later update to progress file.**
-### 3. Gather Experience Level
-Ask:
-"**What is your experience level with testing?**
-Please select one:
-- **Beginner** - New to testing, learning fundamentals
-- **Intermediate** - Have written tests, want to improve
-- **Experienced** - Strong testing background, want advanced techniques
-Your experience level helps me adjust complexity and skip topics you already know."
-**Wait for response.**
-**Validate response:**
-- Must be one of: Beginner, Intermediate, Experienced (case-insensitive)
-- If invalid: "Please select one of the three levels: Beginner, Intermediate, or Experienced"
-- Repeat until valid
-**Store validated experience_level for later update to progress file.**
-### 4. Gather Learning Goals
-Ask:
-"**What are your learning goals?**
-Tell me what you want to achieve with TEA Academy. For example:
-- Learn testing fundamentals from scratch
-- Understand TEA methodology and workflows
-- Improve test quality and reduce flakiness
-- Master advanced patterns (fixtures, network-first, etc.)
-- Prepare for QA onboarding at my company
-**Your answer helps me recommend which sessions to focus on.**"
-**Wait for response.**
-**Validate response:**
-- Must not be empty
-- Should be at least 10 characters
-- If too short: "Please provide more detail about your learning goals (at least a sentence)"
-- Repeat until valid
-**Store learning_goals for later update to progress file.**
-### 5. Gather Pain Points (Optional)
-Ask:
-"**What are your current pain points with testing?** _(Optional)_
-For example:
-- Flaky tests that fail randomly
-- Slow test suites
-- Hard to maintain tests
-- Don't know where to start
-- Team doesn't value testing
-**This helps me provide targeted examples. You can skip this by typing 'skip' or 'none'.**"
-**Wait for response.**
-**Handle response:**
-- If response is "skip", "none", or similar → Set pain_points to null
-- If response is provided → Store pain_points for later update
-- No validation needed (optional field)
-### 6. Summarize Assessment
-Display:
-"✅ **Assessment Complete!**
-Here's what I learned about you:
-**Role:** {role}
-**Experience Level:** {experience_level}
-**Learning Goals:** {learning_goals}
-**Pain Points:** {pain_points or 'None specified'}
-I'll use this to customize examples and recommendations throughout your learning journey."
-### 7. Update Progress File
-Load {progressFile} and update the following fields:
-- `role: {role}`
-- `experience_level: {experience_level}`
-- `learning_goals: {learning_goals}`
-- `pain_points: {pain_points}` (or null if not provided)
-Update stepsCompleted array:
-- Append 'step-02-assess' to stepsCompleted array
-- Update lastStep: 'step-02-assess'
-**Save the updated progress file.**
-### 8. Provide Next Steps Preview
-Display:
-"**Next:** You'll see the session menu where you can choose from 7 learning sessions.
-**Based on your experience level:**
-{If beginner:}
-- I recommend starting with Session 1 (Quick Start)
-- It introduces TEA with a hands-on example
-{If intermediate:}
-- You might want to skip to Session 3 (Architecture)
-- Or review Session 2 (Core Concepts) first if you want fundamentals
-{If experienced:}
-- Feel free to jump to Session 7 (Advanced Patterns)
-- Or pick specific sessions based on your goals
-You can take sessions in any order and pause anytime!"
-### 9. Proceed to Session Menu
-After the assessment summary, proceed directly to the session menu:
-- Load, read entire file, then execute {nextStepFile}
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- All required fields gathered (role, experience_level, learning_goals)
-- Optional pain_points handled correctly
-- All responses validated before proceeding
-- Progress file updated with assessment data
-- stepsCompleted array updated with 'step-02-assess'
-- Experience-based recommendations provided
-- User routed to session menu (step-03)
-### ❌ SYSTEM FAILURE:
-- Skipping validation of required fields
-- Not updating progress file
-- Not adding to stepsCompleted array
-- Proceeding without waiting for user responses
-- Not providing experience-based recommendations
-- Hardcoding responses instead of asking user
-**Master Rule:** Assessment must be complete and validated before proceeding to session menu.