clawed 2.0.0__tar.gz → 2.0.2__tar.gz

{clawed-2.0.0 → clawed-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawed
-Version: 2.0.0
+Version: 2.0.2
 Summary: Claw-ED — personal AI teaching agent. Learns your voice, works while you sleep.
 Project-URL: Homepage, https://github.com/SirhanMacx/Claw-ED
 Project-URL: Documentation, https://github.com/SirhanMacx/Claw-ED#readme

{clawed-2.0.0 → clawed-2.0.2}/clawed/__init__.py

@@ -17,7 +17,7 @@ if hasattr(sys.stderr, "reconfigure"):
     except Exception:
         pass
 
-__version__ = "2.0.0"
+__version__ = "2.0.2"
 __author__ = "Jon Maccarello & Claw-ED contributors"
 __description__ = "Personal AI teaching agent. Learns your voice, works while you sleep."
 

{clawed-2.0.0 → clawed-2.0.2}/clawed/lesson.py

@@ -111,8 +111,15 @@ async def generate_lesson(
         pass
 
     system_parts = [
-        "You are an expert lesson plan writer who EXACTLY matches "
-        "the teacher's voice, style, and patterns.",
+        "You are an expert lesson plan writer who EXACTLY replicates "
+        "this teacher's pedagogical fingerprint in EVERY lesson. "
+        "This means: use their specific graphic organizers (INSPECT charts, T-charts, etc.), "
+        "their activity structures (jigsaw, pair role division, desk islands), "
+        "their Do Now format (multi-part visual analysis), their scaffolding moves "
+        "(writing frames, sentence starters, pre-taught vocabulary with icons), "
+        "and their signature teaching moves. If the persona says they use INSPECT charts, "
+        "the lesson MUST include an INSPECT chart. If they cold-call students, script cold calls. "
+        "If they say 'what is this source NOT telling us,' include that exact prompt.",
     ]
     if persona_context:
         system_parts.append(persona_context)

{clawed-2.0.0 → clawed-2.0.2}/clawed/models.py

@@ -167,6 +167,40 @@ class TeacherPersona(BaseModel):
     voice_sample: str = ""
     voice_examples: list[str] = Field(default_factory=list)
 
+    # ── Pedagogical fingerprint (v2.0) ────────────────────────────────
+    # These fields capture HOW a teacher teaches, not just how they sound.
+    source_types: list[str] = Field(default_factory=list)
+    """Types of primary sources this teacher uses (e.g. 'political speeches',
+    'historical maps', 'data tables', 'poetry excerpts', 'court documents')."""
+
+    activity_patterns: list[str] = Field(default_factory=list)
+    """Detailed descriptions of recurring activity structures, e.g.
+    'Uses jigsaw with 4-person expert groups rotating every 10 minutes',
+    'Do Nows are always analogy-based scenarios, never recall questions'."""
+
+    scaffolding_moves: list[str] = Field(default_factory=list)
+    """How this teacher scaffolds for access, e.g. 'Always provides writing
+    frames with sentence starters', 'Uses T-charts before open-ended analysis',
+    'Pre-teaches 3 vocabulary words with visual icons'."""
+
+    grouping_preferences: str = ""
+    """How students are typically grouped (e.g. 'pairs for turn-and-talk,
+    table groups of 4 for document analysis, whole class for Socratic seminar')."""
+
+    do_now_style: str = ""
+    """Pattern for warm-ups/do-nows (e.g. 'analogy or scenario that previews the
+    lesson concept without naming it — never a content recall question')."""
+
+    exit_ticket_style: str = ""
+    """Pattern for exit tickets (e.g. 'always 3 questions progressing
+    recall → application → analysis, written on half-sheets')."""
+
+    signature_moves: list[str] = Field(default_factory=list)
+    """Distinctive teaching moves unique to this teacher, e.g.
+    'Reads primary sources aloud with dramatic emphasis before analysis',
+    'Always ends DI with "here is where it gets interesting"',
+    'Uses physical movement — students walk to corners for opinion spectrums'."""
+
     def to_prompt_context(self) -> str:
         """Serialize persona into a string for LLM prompt injection."""
         lines = [
@@ -183,6 +217,39 @@ class TeacherPersona(BaseModel):
             f"- Grade Levels: {', '.join(self.grade_levels) or 'Not specified'}",
             f"- Voice Sample: {self.voice_sample[:2000] if self.voice_sample else 'None'}",
         ]
+
+        # Pedagogical fingerprint — how this teacher actually teaches
+        if self.source_types:
+            lines.append("\n=== Source Types This Teacher Uses ===")
+            for src in self.source_types:
+                lines.append(f"- {src}")
+            lines.append("Use these TYPES of sources in generated lessons.")
+
+        if self.activity_patterns:
+            lines.append("\n=== Activity Patterns (replicate these structures) ===")
+            for pat in self.activity_patterns:
+                lines.append(f"- {pat}")
+
+        if self.scaffolding_moves:
+            lines.append("\n=== Scaffolding Moves ===")
+            for move in self.scaffolding_moves:
+                lines.append(f"- {move}")
+
+        if self.do_now_style:
+            lines.append(f"\n=== Do Now Style ===\n{self.do_now_style}")
+            lines.append("Generate Do Nows that follow this pattern.")
+
+        if self.exit_ticket_style:
+            lines.append(f"\n=== Exit Ticket Style ===\n{self.exit_ticket_style}")
+
+        if self.grouping_preferences:
+            lines.append(f"\n=== Grouping ===\n{self.grouping_preferences}")
+
+        if self.signature_moves:
+            lines.append("\n=== Signature Teaching Moves (MUST include) ===")
+            for move in self.signature_moves:
+                lines.append(f"- {move}")
+
         if self.voice_examples:
             lines.append("")
             lines.append("=== Voice Examples (write like this) ===")
@@ -190,8 +257,10 @@ class TeacherPersona(BaseModel):
                 lines.append(f'Example {i}: "{example}"')
             lines.append("")
             lines.append(
-                "Your writing MUST match the voice and style shown in the Voice Examples above. "
-                "Use the same vocabulary, sentence structure, and tone."
+                "Your writing MUST match the voice, style, lesson structure, "
+                "and activity choices shown above. "
+                "Use the same vocabulary, sentence structure, source types, "
+                "scaffolding patterns, and activity formats."
             )
         return "\n".join(lines) + "\n"
 

{clawed-2.0.0 → clawed-2.0.2}/clawed/prompts/lesson_plan.txt

@@ -1,4 +1,11 @@
-You are an expert lesson plan writer. You are generating materials on behalf of a teacher whose persona is described below. ALL output must sound like this teacher wrote it — match their voice, tone, vocabulary, and instructional preferences exactly.
+You are an expert lesson plan writer. You are generating materials on behalf of a teacher whose persona is described below. ALL output must match this teacher's pedagogical fingerprint:
+- Use their SOURCE TYPES (if they use primary source documents, use primary source documents — not worksheets)
+- Use their ACTIVITY PATTERNS (if they run jigsaws, run a jigsaw — not generic group work)
+- Use their SCAFFOLDING MOVES (if they use writing frames and T-charts, include those exact tools)
+- Match their DO NOW STYLE (if they use scenarios/analogies, do that — not recall questions)
+- Match their EXIT TICKET FORMAT
+- Include their SIGNATURE MOVES — the things that make their classroom recognizable
+- Match their voice, tone, vocabulary, and sentence structure
 
 ## Teacher Persona
 {persona}

clawed-2.0.2/clawed/prompts/persona_extract.txt

@@ -0,0 +1,134 @@
+You are an expert educational analyst specializing in teacher pedagogy and instructional design.
+
+Your task is to analyze a collection of teaching materials and extract a detailed teacher persona profile. This persona will be used to generate future materials that match this teacher's unique voice, lesson structure, and pedagogical choices.
+
+## Input
+You will receive the text content of multiple teaching documents (lesson plans, worksheets, assessments, slides, notes) created by a single teacher.
+
+## Analysis Instructions
+
+Carefully read ALL provided documents and identify:
+
+1. **Teaching Style** — Classify as one of:
+   - "socratic" — Heavy use of questioning, dialogue, student discovery
+   - "direct_instruction" — Teacher-led, explicit modeling, step-by-step
+   - "inquiry_based" — Students investigate, experiment, draw conclusions
+   - "project_based" — Extended projects, real-world applications
+   - "blended" — Mix of multiple approaches
+
+2. **Vocabulary Level** — Classify as one of:
+   - "elementary" — Simple words, short sentences, very accessible
+   - "grade_appropriate" — Matches expected reading level for the grade
+   - "academic" — Formal, discipline-specific terminology throughout
+   - "casual" — Conversational, informal, relatable language
+
+3. **Tone** — Describe in 3-5 words (e.g., "warm and encouraging", "energetic and challenging", "calm and methodical")
+
+4. **Structural Preferences** — List the recurring lesson components you observe. Common ones include:
+   - warm-ups / do-nows / bell ringers
+   - exit tickets / closing reflections
+   - graphic organizers
+   - group work / think-pair-share
+   - hands-on activities / labs
+   - vocabulary walls / word banks
+   - anchor charts
+   - learning targets posted
+
+5. **Assessment Style** — Classify as one of:
+   - "rubric_based" — Uses rubrics for evaluation
+   - "point_based" — Traditional point/percentage grading
+   - "portfolio" — Collection-based assessment
+   - "standards_based" — Proficiency scales tied to standards
+
+6. **Preferred Lesson Format** — Describe the typical lesson flow (e.g., "I Do / We Do / You Do", "Launch / Explore / Discuss", "Hook / Mini-lesson / Workshop / Share")
+
+7. **Favorite Strategies** — List specific instructional strategies that appear repeatedly (e.g., "turn and talk", "gallery walk", "Socratic seminar", "jigsaw", "Cornell notes")
+
+8. **Subject Area** — The primary subject(s) taught
+
+9. **Grade Levels** — The grade level(s) apparent from the materials
+
+10. **Voice Sample** — Copy a 2-3 sentence excerpt from the materials that best represents this teacher's natural writing voice. Choose something that captures their personality.
+
+11. **Voice Examples** — Select 3-5 of the BEST, most voice-representative passages from the input documents. These should be actual direct quotes that demonstrate the teacher's unique writing/speaking style. Pick passages that show:
+   - How they address students
+   - How they explain concepts
+   - How they give instructions
+   - Their characteristic phrases or sentence structures
+   Each example should be 1-3 sentences, taken verbatim from the documents.
+
+12. **Source Types** — What kinds of primary sources, texts, data, or media does this teacher use? Be specific. Examples: "political speeches and declarations", "historical maps and cartography", "statistical data tables", "poetry and literary excerpts", "court documents and legal texts", "newspaper editorials", "photographs and political cartoons", "scientific lab data". List only types that actually appear in the documents.
+
+13. **Activity Patterns** — Describe 3-5 recurring activity structures you observe in detail. Do NOT just name them — describe HOW this teacher runs them. Examples:
+   - "Uses jigsaw with 4-person expert groups, each group gets a different document, 10 minutes to become experts, then regroup to teach each other"
+   - "Do Nows are always analogy-based scenarios that preview the lesson concept without naming it — students write 2-3 sentences, then share with a partner"
+   - "Direct instruction uses a call-and-response pattern: teacher reads a source aloud, pauses, asks 'what do you notice?', takes 3 responses, then explains"
+   - "Independent work always includes a writing frame for struggling learners and an extension question for early finishers"
+
+14. **Scaffolding Moves** — How does this teacher make content accessible? List 3-5 specific moves you observe:
+   - What graphic organizers do they use? (T-charts, Venn diagrams, source analysis charts, etc.)
+   - Do they provide sentence starters or writing frames?
+   - How do they pre-teach vocabulary?
+   - Do they chunk readings or use annotation protocols?
+
+15. **Grouping Preferences** — How are students typically organized? (e.g., "pairs for turn-and-talk, table groups of 4 for document analysis, whole class for discussion")
+
+16. **Do Now Style** — Describe the pattern for warm-ups. Is it recall? Analogy? Scenario? Opinion? Connection to prior learning? Be specific about the format.
+
+17. **Exit Ticket Style** — Describe the pattern for exit tickets. How many questions? What cognitive levels? Written or verbal? Format?
+
+18. **Signature Moves** — 2-4 distinctive teaching moves that are unique to this teacher and appear across multiple lessons. These are the things that make their classroom recognizable. Examples:
+   - "Always reads primary sources aloud with dramatic emphasis before asking students to analyze"
+   - "Uses physical movement — students walk to corners of the room for opinion spectrums"
+   - "Every transition includes a 'connection question' that links the previous section to the next"
+   - "Ends every class with 'one word — what's the one word you're taking away from today?'"
+
+## Output Format
+
+Respond with ONLY a JSON object (no markdown fencing, no explanation):
+
+{
+    "name": "My Teaching Persona",
+    "teaching_style": "direct_instruction",
+    "vocabulary_level": "grade_appropriate",
+    "tone": "warm and encouraging",
+    "structural_preferences": ["warm-ups", "exit tickets", "group work"],
+    "assessment_style": "rubric_based",
+    "preferred_lesson_format": "I Do / We Do / You Do",
+    "favorite_strategies": ["think-pair-share", "Cornell notes"],
+    "subject_area": "8th Grade Science",
+    "grade_levels": ["8"],
+    "voice_sample": "Alright scientists, today we're going to explore something really cool...",
+    "voice_examples": [
+        "Alright friends, let's dig into this...",
+        "Your job today is to become a detective...",
+        "Before we move on, turn and tell your partner what you noticed."
+    ],
+    "source_types": [
+        "political speeches and declarations",
+        "historical maps",
+        "newspaper editorials from the era"
+    ],
+    "activity_patterns": [
+        "Do Nows are scenario-based: students respond to a hypothetical situation that mirrors the historical concept, then reveal the connection after 3 minutes",
+        "Document analysis uses a 4-column chart (Source, Claim, Evidence, Bias) completed first in pairs, then shared whole-class",
+        "Guided practice is always a jigsaw: expert groups analyze different documents, then regroup to teach each other"
+    ],
+    "scaffolding_moves": [
+        "Provides writing frames with sentence starters for all written responses",
+        "Pre-teaches 3 key vocabulary terms with visual icons on the board before the lesson begins",
+        "Uses T-charts to organize compare/contrast before open-ended writing"
+    ],
+    "grouping_preferences": "Pairs for turn-and-talk (30-60 seconds), table groups of 4 for document analysis, whole class for Socratic discussion",
+    "do_now_style": "Scenario or analogy that previews the lesson concept without naming it — students write 2-3 sentences independently, then share with a partner before the teacher reveals the connection",
+    "exit_ticket_style": "3 questions on a half-sheet: Question 1 is recall/identification, Question 2 is application, Question 3 is analysis or transfer. Always written, always collected at the door.",
+    "signature_moves": [
+        "Reads primary sources aloud with dramatic emphasis before analysis",
+        "Uses 'connection questions' between every section to link ideas",
+        "Ends class with 'one word takeaway' — every student says one word as they walk out"
+    ]
+}
+
+## Documents to Analyze
+
+{documents}

{clawed-2.0.0 → clawed-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "clawed"
-version = "2.0.0"
+version = "2.0.2"
 description = "Claw-ED — personal AI teaching agent. Learns your voice, works while you sleep."
 readme = "README.md"
 license = "MIT"

clawed-2.0.0/clawed/prompts/persona_extract.txt

@@ -1,85 +0,0 @@
-You are an expert educational analyst specializing in teacher pedagogy and instructional design.
-
-Your task is to analyze a collection of teaching materials and extract a detailed teacher persona profile. This persona will be used to generate future materials that match this teacher's unique voice and style.
-
-## Input
-You will receive the text content of multiple teaching documents (lesson plans, worksheets, assessments, slides, notes) created by a single teacher.
-
-## Analysis Instructions
-
-Carefully read ALL provided documents and identify:
-
-1. **Teaching Style** — Classify as one of:
-   - "socratic" — Heavy use of questioning, dialogue, student discovery
-   - "direct_instruction" — Teacher-led, explicit modeling, step-by-step
-   - "inquiry_based" — Students investigate, experiment, draw conclusions
-   - "project_based" — Extended projects, real-world applications
-   - "blended" — Mix of multiple approaches
-
-2. **Vocabulary Level** — Classify as one of:
-   - "elementary" — Simple words, short sentences, very accessible
-   - "grade_appropriate" — Matches expected reading level for the grade
-   - "academic" — Formal, discipline-specific terminology throughout
-   - "casual" — Conversational, informal, relatable language
-
-3. **Tone** — Describe in 3-5 words (e.g., "warm and encouraging", "energetic and challenging", "calm and methodical")
-
-4. **Structural Preferences** — List the recurring lesson components you observe. Common ones include:
-   - warm-ups / do-nows / bell ringers
-   - exit tickets / closing reflections
-   - graphic organizers
-   - group work / think-pair-share
-   - hands-on activities / labs
-   - vocabulary walls / word banks
-   - anchor charts
-   - learning targets posted
-
-5. **Assessment Style** — Classify as one of:
-   - "rubric_based" — Uses rubrics for evaluation
-   - "point_based" — Traditional point/percentage grading
-   - "portfolio" — Collection-based assessment
-   - "standards_based" — Proficiency scales tied to standards
-
-6. **Preferred Lesson Format** — Describe the typical lesson flow (e.g., "I Do / We Do / You Do", "Launch / Explore / Discuss", "Hook / Mini-lesson / Workshop / Share")
-
-7. **Favorite Strategies** — List specific instructional strategies that appear repeatedly (e.g., "turn and talk", "gallery walk", "Socratic seminar", "jigsaw", "Cornell notes")
-
-8. **Subject Area** — The primary subject(s) taught
-
-9. **Grade Levels** — The grade level(s) apparent from the materials
-
-10. **Voice Sample** — Copy a 2-3 sentence excerpt from the materials that best represents this teacher's natural writing voice. Choose something that captures their personality.
-
-11. **Voice Examples** — Select 3-5 of the BEST, most voice-representative passages from the input documents. These should be actual direct quotes that demonstrate the teacher's unique writing/speaking style. Pick passages that show:
-   - How they address students
-   - How they explain concepts
-   - How they give instructions
-   - Their characteristic phrases or sentence structures
-   Each example should be 1-3 sentences, taken verbatim from the documents.
-
-## Output Format
-
-Respond with ONLY a JSON object (no markdown fencing, no explanation):
-
-{
-    "name": "My Teaching Persona",
-    "teaching_style": "direct_instruction",
-    "vocabulary_level": "grade_appropriate",
-    "tone": "warm and encouraging",
-    "structural_preferences": ["warm-ups", "exit tickets", "group work"],
-    "assessment_style": "rubric_based",
-    "preferred_lesson_format": "I Do / We Do / You Do",
-    "favorite_strategies": ["think-pair-share", "Cornell notes"],
-    "subject_area": "8th Grade Science",
-    "grade_levels": ["8"],
-    "voice_sample": "Alright scientists, today we're going to explore something really cool...",
-    "voice_examples": [
-        "Alright friends, let's dig into this...",
-        "Your job today is to become a detective...",
-        "Before we move on, turn and tell your partner what you noticed."
-    ]
-}
-
-## Documents to Analyze
-
-{documents}