Skip to content

Commit cbd9417

Browse files
kinclkincl
authored
Initial commit
0 parents  commit cbd9417

85 files changed

Lines changed: 21808 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/CHANGELOG-2026-01-09.md‎

Lines changed: 194 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,194 @@
1+
# Claude Skills Changelog - January 9, 2026
2+
3+
## Summary
4+
5+
Updated Claude Code skills for Red Hat Showroom content generation to be more interactive, conversational, and user-friendly.
6+
7+
## Changes Made
8+
9+
### 1. Fixed "First Module" Wording in create-demo
10+
11+
**Before:**
12+
```
13+
Q: Is this the first module of a new demo, or continuing an existing demo?
14+
15+
Options:
16+
1. First module of a NEW demo
17+
2. Continuing an EXISTING demo
18+
```
19+
20+
**After:**
21+
```
22+
Q: Are you creating a new demo or continuing an existing one?
23+
24+
Options:
25+
1. 🆕 Creating a NEW demo (I'll help you plan the whole story)
26+
2. ➡️ Continuing an EXISTING demo (I'll pick up where you left off)
27+
```
28+
29+
**Rationale:** "First module of a NEW demo" was redundant - if it's a new demo, we're obviously creating the first module.
30+
31+
### 2. Made Questions More Interactive
32+
33+
**Before:**
34+
- Dry bullet points
35+
- Technical language
36+
- "Q:" prefix
37+
- "Your choice? [1/2/3]"
38+
39+
**After:**
40+
- Friendly conversational tone
41+
- Emojis for visual guidance
42+
- Welcome messages ("Let's get started! I'll help you create amazing demo content.")
43+
- "What's your situation? [1/2/3]"
44+
- Question blocks with context and examples
45+
46+
**Example - Lab Planning Questions:**
47+
```
48+
**Question 1 - What Should We Call This?**:
49+
```
50+
What's the name of your workshop?
51+
52+
Example: "Building AI/ML Workloads on OpenShift AI"
53+
54+
I'll use this to set up your lab title and generate a clean URL-friendly slug.
55+
56+
Your lab name:
57+
58+
[After user provides title, I'll suggest a slug like "building-ai-ml-workloads-openshift-ai"]
59+
```
60+
```
61+
62+
### 3. Simplified AgnosticV Question
63+
64+
**Before:** 4 options
65+
```
66+
Options:
67+
1. No, already set up → Skip to Step 3
68+
2. No, I'll handle it myself → Skip to Step 3
69+
3. Yes, help me create new catalog → Continue ↓
70+
4. What's AgnosticV? → Explain
71+
72+
Your choice? [1/2/3/4]
73+
```
74+
75+
**After:** 3 options
76+
```
77+
1. ⏭️ Skip this (I'll handle it or it's already set up)
78+
2. 🆘 Yes, help me create a new catalog
79+
3. ❓ What's AgnosticV? (explain it to me)
80+
81+
What's your situation? [1/2/3]
82+
```
83+
84+
**Rationale:** "Already set up" and "I'll handle it myself" both mean "skip this" - combined them into one option.
85+
86+
### 4. Added Target Directory Question to Interactive Mode
87+
88+
**Issue:** Directory argument support existed (`/create-lab <directory>`) but interactive mode didn't ask for it.
89+
90+
**Added:** Step 1.5 in both create-lab and create-demo skills
91+
```
92+
### Step 1.5: Ask for Target Directory (if not provided as argument)
93+
94+
**SKIP THIS STEP IF**: User provided `<directory>` as argument
95+
96+
**Ask the user**:
97+
```
98+
Where should I create the lab/demo files?
99+
100+
Default location: content/modules/ROOT/pages/
101+
102+
Press Enter to use default, or type a different path:
103+
```
104+
105+
**Validation**:
106+
- If directory doesn't exist, ask: "Directory not found. Create it? [Yes/No]"
107+
- If Yes, create the directory
108+
- If No, ask again for directory
109+
```
110+
111+
**Commits:**
112+
- nookbag: `b7dfd75` - "Add target directory question to interactive mode (Step 1.5)"
113+
- maas: `f351bf0` - "Add target directory question to interactive mode (Step 1.5)"
114+
115+
### 5. Created User-Facing Documentation
116+
117+
**Created:** `CLAUDE-SKILLS-GUIDE.adoc` (466 lines)
118+
- Quick start for Claude Code CLI and Cursor IDE
119+
- All 4 skills with usage examples (/create-lab, /create-demo, /verify-content, /blog-generate)
120+
- Interactive workflow explanations
121+
- Common workflows (new workshop, add modules, create demos)
122+
- Pro tips for content creators
123+
- AgV integration guide (advanced users)
124+
- Quality standards and troubleshooting
125+
126+
**Updated:** `.claude/INTERNAL-DEVELOPER-GUIDE.adoc`
127+
- Added Step 1.5 to workflow documentation
128+
- Expanded workflow from 8 to 12 steps
129+
- Added January 9, 2026 version history entry
130+
- Changed CLAUDE-SKILLS-GUIDE.md reference to .adoc
131+
132+
**Commits:**
133+
- nookbag: `4a2fbcf` - "Add user-facing quick start guide and update internal docs"
134+
- maas: `23e20cc` - "Update user-facing guide with interactive questions and comprehensive examples"
135+
136+
## Files Updated
137+
138+
### Repositories Synced
139+
140+
1. **showroom_template_nookbag** (master template repo)
141+
- `.claude/skills/create-demo/SKILL.md`
142+
- `.claude/skills/create-lab/SKILL.md`
143+
- Commits:
144+
- `1f775d1` - "Fix create-demo wording: new demo instead of first module"
145+
- `d449627` - "Make skill questions more interactive and conversational"
146+
- `77fe0d9` - "Simplify AgV question: combine 'already set up' and 'handle myself' options"
147+
148+
2. **maas-usage-examples** (production repo)
149+
- `.claude/skills/create-demo/SKILL.md`
150+
- `.claude/skills/create-lab/SKILL.md`
151+
- Commits:
152+
- `3c937e4` - "Fix create-demo wording: new demo instead of first module"
153+
- `4cecb20` - "Make skill questions more interactive and conversational"
154+
- `d0ed73d` - "Simplify AgV question: combine 'already set up' and 'handle myself' options"
155+
156+
3. **~/.claude/** (global Claude configuration)
157+
- Synced entire `.claude/` directory from nookbag
158+
- 63 files transferred including:
159+
- 4 skills (blog-generate, create-demo, create-lab, verify-content)
160+
- 22 templates (demo/, workshop/)
161+
- 8 agents
162+
- 10 verification prompts
163+
- Documentation (SKILL-COMMON-RULES.md, INTERNAL-DEVELOPER-GUIDE.adoc)
164+
- Added user-facing documentation:
165+
- CLAUDE-SKILLS-GUIDE.adoc (466 lines)
166+
- Updated INTERNAL-DEVELOPER-GUIDE.adoc (with Step 1.5 and version history)
167+
168+
## Impact
169+
170+
- **Better user experience:** More welcoming and conversational
171+
- **Clearer options:** No redundant choices
172+
- **Faster workflows:** Less cognitive load to understand what to choose
173+
- **Consistent across repos:** All production repos use same interactive style
174+
175+
## Previous Work Today
176+
177+
Earlier today (before these changes):
178+
- Added lab name configuration (Step 2.1) to update site.yml and antora.yml
179+
- Moved templates from `content/modules/ROOT/pages/` to `.claude/templates/` to fix dev mode
180+
- Embedded conclusion templates in skills (removed external file dependencies)
181+
- Removed certification sections (not applicable for internal RHDP)
182+
- Added Sales Engineer/Solution Architect action items to demo conclusions
183+
184+
## Testing
185+
186+
All changes automatically work in both:
187+
- ✅ Claude Code CLI
188+
- ✅ Cursor IDE (rules are thin wrappers that execute full `.claude/skills/` files)
189+
190+
## Notes
191+
192+
- Global ~/.claude is NOT a git repo (intentional - contains session history and cache)
193+
- Project-level .claude directories ARE tracked in git (nookbag, maas, etc.)
194+
- Sync strategy: nookbag is master → copy to production repos → rsync to ~/.claude

‎.claude/CHANGELOG-2026-01-11.md‎

Lines changed: 199 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,199 @@
1+
# Claude Skills Changelog - January 11, 2026
2+
3+
## Summary
4+
5+
Major refactoring of content creation workflow to improve modularity and content organization. Made troubleshooting sections optional, conclusion modules mandatory, and consolidated all references into conclusion modules.
6+
7+
## Changes Made
8+
9+
### 1. Troubleshooting Section - Now Optional
10+
11+
**Before:**
12+
- Troubleshooting section was REQUIRED for every module
13+
- Generated automatically without asking user
14+
- All modules had troubleshooting even for simple tutorials
15+
16+
**After:**
17+
- Added user question in Step 3: "Would you like to include a troubleshooting section?"
18+
- Options: Yes (recommended for production) or No (skip for now)
19+
- Provides clear guidance on when to recommend each option
20+
21+
**Rationale:** Simple introductory modules and basic tutorials don't need extensive troubleshooting. Only complex production workshops benefit from detailed troubleshooting sections.
22+
23+
**Files Updated:**
24+
- `.claude/skills/create-lab/SKILL.md`
25+
- `.claude/skills/create-demo/SKILL.md`
26+
- `.claude/prompts/verify_workshop_structure.txt`
27+
- `.claude/prompts/enhanced_verification_workshop.txt`
28+
- `.claude/prompts/enhanced_verification_demo.txt`
29+
30+
---
31+
32+
### 2. Conclusion Module - Now Mandatory
33+
34+
**Before:**
35+
- Step 12: "Offer to Generate Conclusion Module (Optional)"
36+
- Asked after all modules were done
37+
- Users could skip conclusion entirely
38+
39+
**After:**
40+
- Step 12: "Generate Conclusion Module (MANDATORY)"
41+
- Asks "Is this the last module?" after each module creation
42+
- If YES: Generates conclusion immediately
43+
- If NO: Waits for final module
44+
45+
**Rationale:** Every workshop and demo needs a proper conclusion to wrap up learning, provide next steps, and consolidate references. Making it mandatory ensures better content quality.
46+
47+
**Files Updated:**
48+
- `.claude/skills/create-lab/SKILL.md`
49+
- `.claude/skills/create-demo/SKILL.md`
50+
- `.claude/prompts/verify_workshop_structure.txt`
51+
52+
---
53+
54+
### 3. References - Consolidated in Conclusion Only
55+
56+
**Before:**
57+
- Each module had its own References section at the end
58+
- Duplicate references across multiple modules
59+
- References scattered throughout content
60+
61+
**After:**
62+
- Individual modules have NO References sections
63+
- ALL references consolidated in conclusion module only
64+
- Organized by category:
65+
- Official Documentation
66+
- Red Hat Resources
67+
- Customer Success Stories (demos)
68+
- Community and Open Source
69+
- Additional Reading
70+
71+
**Reference Curation Workflow:**
72+
1. Extract all external links from all modules
73+
2. Show user the complete list
74+
3. Ask user how to handle:
75+
- Option 1: Use as-is (auto-organize by category)
76+
- Option 2: Add more references
77+
- Option 3: Curate (add/remove specific items)
78+
79+
**Rationale:** Consolidated references are easier to maintain, prevent duplication, and provide a comprehensive bibliography for the entire workshop/demo.
80+
81+
**Files Updated:**
82+
- `.claude/skills/create-lab/SKILL.md` - Removed References from module structure
83+
- `.claude/skills/create-demo/SKILL.md` - Removed References from module structure
84+
- `.claude/prompts/verify_workshop_structure.txt` - Added conclusion requirement
85+
- `.claude/prompts/enhanced_verification_workshop.txt` - Added reference consolidation check
86+
- `.claude/prompts/enhanced_verification_demo.txt` - Added reference consolidation check
87+
88+
---
89+
90+
### 4. External Link Format - Validation Added
91+
92+
**Before:**
93+
- Only demo accessibility verification checked for `^` caret
94+
- Workshop verification didn't validate external link format
95+
- Inconsistent enforcement
96+
97+
**After:**
98+
- ALL verification prompts check for `^` caret on external links
99+
- Format: `link:https://example.com[Link Text^]`
100+
- Clear distinction: External links use `^`, internal xrefs do NOT
101+
102+
**Example Validation:**
103+
```asciidoc
104+
❌ INVALID: link:https://docs.redhat.com/...[Documentation]
105+
✅ CORRECT: link:https://docs.redhat.com/...[Documentation^]
106+
107+
✅ CORRECT: xref:next-module.adoc[Next Module] (no caret for internal)
108+
```
109+
110+
**Rationale:** External links opening in new tabs prevent learners from losing their place in workshops. This is critical for user experience but was inconsistently enforced.
111+
112+
**Files Updated:**
113+
- `.claude/prompts/verify_accessibility_compliance_workshop.txt` - Added Section 6
114+
- `.claude/prompts/enhanced_verification_workshop.txt` - Added external link requirements
115+
- `.claude/prompts/enhanced_verification_demo.txt` - Added external link requirements
116+
117+
---
118+
119+
## Impact
120+
121+
**For Content Creators:**
122+
- More control over module complexity (optional troubleshooting)
123+
- Better organized references (all in one place)
124+
- Guaranteed proper conclusions (mandatory)
125+
- Clearer guidance on when to use features
126+
127+
**For Content Quality:**
128+
- Consistent reference formatting
129+
- Proper external link handling
130+
- Better module organization
131+
- Improved verification coverage
132+
133+
**For Learners:**
134+
- External links don't break learning flow
135+
- Comprehensive references in one location
136+
- Better conclusions with clear next steps
137+
138+
---
139+
140+
## Migration Notes
141+
142+
**For Existing Content:**
143+
144+
If you have existing workshops/demos created before this change:
145+
146+
1. **Troubleshooting sections**: Keep them if already present (still valid)
147+
2. **References**: Consider consolidating into conclusion module for consistency
148+
3. **External links**: Run `/verify-content` to check for missing `^` carets
149+
4. **Conclusion**: Add if missing (now required for all content)
150+
151+
**For New Content:**
152+
153+
All new workshops and demos created with `/create-lab` or `/create-demo` will:
154+
- Ask about troubleshooting preference
155+
- Automatically generate mandatory conclusion
156+
- Consolidate references with user curation
157+
- Validate external link format
158+
159+
---
160+
161+
## Files Changed
162+
163+
```
164+
.claude/skills/create-lab/SKILL.md (+216, -39)
165+
.claude/skills/create-demo/SKILL.md (+171, -18)
166+
.claude/prompts/verify_workshop_structure.txt (+28, -5)
167+
.claude/prompts/enhanced_verification_workshop.txt (+44, -4)
168+
.claude/prompts/enhanced_verification_demo.txt (+39, -3)
169+
.claude/prompts/verify_accessibility_compliance_workshop.txt (+45, -2)
170+
.claude/prompts/verify_accessibility_compliance_demo.txt (+20, -5)
171+
.claude/CHANGELOG-2026-01-11.md (new file)
172+
CLAUDE-SKILLS-GUIDE.adoc (updated)
173+
```
174+
175+
**Total:** 9 files changed, 788 insertions(+), 93 deletions(-)
176+
177+
**Git Commits:**
178+
- `ad1130d` - Refactor content creation workflow: optional troubleshooting, mandatory conclusion, consolidated references
179+
- `1d5da0b` - Add clickable image link validation and update documentation
180+
- `8723c79` - Add active validation checks for clickable image links
181+
182+
---
183+
184+
## Verification
185+
186+
Run `/verify-content` on your workshop or demo to validate:
187+
- ✅ Conclusion module exists
188+
- ✅ No References sections in individual modules
189+
- ✅ All references consolidated in conclusion
190+
- ✅ External text links use `^` caret (actively scanned)
191+
- ✅ **External image links use `^` caret** (actively scanned - NEW)
192+
- ✅ Internal xrefs do NOT use `^` caret (actively scanned)
193+
- ⚠️ Troubleshooting sections (optional, context-dependent)
194+
195+
**NEW: Active Scanning for Image Links:**
196+
The verification now actively scans for these patterns and flags errors:
197+
- `image::file.png[Alt,link=https://example.com]` ❌ Missing ^
198+
- `link:https://example.com[image:file.png[Alt]]` ❌ Missing ^
199+
- Shows exact location and correct version in validation output

0 commit comments

Comments
 (0)