final-version

agents/analysis_phase/objectives.py

@@ -72,9 +72,8 @@ objectives_generator = Agent(
 objectives_task = Task(
     description=(
         "You have a complete and well-structured training curriculum provided in {outlines}. "
-        "Your task is to create one detailed, measurable learning objective in Arabic for each subtopic, "
+        "Your task is to create one detailed, measurable learning objective in Arabic for each subtopic(Axis of unit from outlines) , "
         "aligned with Bloom’s Taxonomy and the three learning domains, and consistent with the purpose of each subtopic.\n\n"
-
         "### Step-by-Step Process\n"
         "1. Read the curriculum overview to understand the full learning journey.\n"
         "2. **Before you begin, review the complete list of Bloom’s action verbs and the three domains for each level to plan maximum diversity.**\n"
@@ -90,31 +89,40 @@ objectives_task = Task(
         "      - Choose three relevant Bloom’s verbs that suit the abilities of {audience}.\n"
         "      - Write one measurable learning objective in Arabic that accurately reflects the subtopic’s purpose.\n"
         "      - **Track the chosen verb to prevent reusing it in later objectives.**\n\n"
-
         "### Requirements for the Three Learning Domains\n"
         "**Objectives must cover the three domains in a balanced way:**\n\n"
-
         f"**1. Cognitive Domain (Knowledge):**\n"
         f"{objectives_dimensions['Knowledge']['description']}\n"
         "**Levels:**\n"
-        + "\n".join([f"   - {level['level_name']}: {level['description']}\n     Verbs: {', '.join(level['verbs_examples'])}"
-                     for level in objectives_dimensions['Knowledge']['levels']]) + "\n\n"
-
+        + "\n".join(
+            [
+                f"   - {level['level_name']}: {level['description']}\n     Verbs: {', '.join(level['verbs_examples'])}"
+                for level in objectives_dimensions["Knowledge"]["levels"]
+            ]
+        )
+        + "\n\n"
         f"**2. Affective Domain (Attitude/Ability):**\n"
         f"{objectives_dimensions['Ability']['description']}\n"
         "**Levels:**\n"
-        + "\n".join([f"   - {level['level_name']}: {level['description']}\n     Verbs: {', '.join(level['verbs_examples'])}"
-                     for level in objectives_dimensions['Ability']['levels']]) + "\n\n"
-
+        + "\n".join(
+            [
+                f"   - {level['level_name']}: {level['description']}\n     Verbs: {', '.join(level['verbs_examples'])}"
+                for level in objectives_dimensions["Ability"]["levels"]
+            ]
+        )
+        + "\n\n"
         f"**3. Psychomotor Domain (Skills):**\n"
         f"{objectives_dimensions['Skills']['description']}\n"
         "**Levels:**\n"
-        + "\n".join([f"   - {level['level_name']}: {level['description']}\n     Verbs: {', '.join(level['verbs_examples'])}"
-                     for level in objectives_dimensions['Skills']['levels']]) + "\n\n"
-
+        + "\n".join(
+            [
+                f"   - {level['level_name']}: {level['description']}\n     Verbs: {', '.join(level['verbs_examples'])}"
+                for level in objectives_dimensions["Skills"]["levels"]
+            ]
+        )
+        + "\n\n"
         "### Critical Requirement: Verb Diversity \n"
         "**This is a top-priority rule that must be followed precisely:**\n\n"
-
         "**Verb Non-Repetition Rules:**\n"
         "1. **Maximize verb diversity** — each objective should ideally use a different verb than all previous ones.\n"
         "2. **Before selecting a verb, check:** Have I used this verb before? If yes, choose another.\n"
@@ -129,44 +137,35 @@ objectives_task = Task(
         "   - Space it out by at least 3–5 objectives.\n"
         "   - Add a justification note in your internal reasoning.\n"
         "   - Try using it in a different context or content area.\n\n"
-
         "### The 12 Mandatory Design Standards — Each Objective Must Meet All\n"
         "**Based on the detailed objectives reference document:**\n\n"
-
         "1. **Linked to the general goal:**\n"
         "   - Every objective must connect to the course’s overall goal.\n"
         "   - Example: If the general goal is 'Understand the concept of e-learning', "
         "the specific objective could be 'The trainee accurately defines e-learning.'\n\n"
-
         "2. **Measurable:**\n"
         "   - Objectives must be assessable using measurable performance indicators or outcomes.\n"
         "   - Correct: 'The trainee compares synchronous and asynchronous learning accurately.'\n"
         "   - Incorrect: 'The trainee understands e-learning.' (Not measurable)\n\n"
-
         "3. **Achievable:**\n"
         "   - Realistic, suitable for learner ability and course duration.\n"
         "   - Correct: 'The trainee applies the steps to create a learning management account.'\n"
         "   - Incorrect: 'The trainee develops a full e-learning system in one hour.' (Unrealistic)\n\n"
-
         "4. **Covers all three domains (Cognitive, Psychomotor, Affective):**\n"
         "   - Cognitive: 'The trainee defines e-learning accurately.'\n"
         "   - Psychomotor: 'The trainee practices using LMS assessment tools.'\n"
         "   - Affective: 'The trainee demonstrates interest in participating in e-learning activities.'\n\n"
-
         "5. **Aligned with Bloom’s hierarchy:**\n"
         "   - Objectives must progress logically from lower to higher levels (Remember → Create).\n\n"
-
         "6. **Clarity and precision:** Objective must be completely clear and specific.\n\n"
         "7. **Free from ambiguity:** No vague or overly complex phrasing.\n\n"
         "8. **Vocabulary clarity:** All terms must be understandable to {audience}.\n\n"
         "9. **Single, focused goal:** Each objective expresses only one learning outcome.\n"
         "   - Correct: 'The trainee identifies the components of a virtual classroom.'\n"
         "   - Incorrect: 'The trainee identifies and applies virtual classroom components.'\n\n"
-
         "10. **Realistic and feasible:** Achievable within program time and resources.\n\n"
         "11. **Consistent with program outcomes:** Must align with the general and specific learning outcomes.\n\n"
         "12. **Content-linked:** Directly related to the unit or module content.\n\n"
-
         "### Objective Writing Rules\n"
         "- One objective per subtopic — no more, no less.\n"
         "- Each must directly and precisely reflect the subtopic’s purpose.\n"
@@ -179,7 +178,6 @@ objectives_task = Task(
         "- Ensure objectives are **measurable** and **achievable**.\n"
         "- Maintain linguistic clarity — no vague or double meanings.\n"
         "- Each objective must express only one precise learning outcome.\n\n"
-
         "### Strategies for Verb Diversity\n"
         "**Use these strategies to ensure maximum variety:**\n\n"
         "- **Alternate synonyms:**\n"
@@ -190,7 +188,6 @@ objectives_task = Task(
         "  - Use verbs that capture the learning result precisely.\n"
         "- **Consult the full domain verb lists** (above) with 5–7 verbs per level.\n"
         "- **Distribute objectives across the three domains** — avoid focusing only on the cognitive domain.\n\n"
-
         "### Examples of Correct and Incorrect Objectives\n\n"
         "**Correct Examples (Good verb diversity and domain balance):**\n"
         "1. (Cognitive - Remember): The trainee lists five types of e-learning platforms.\n"
@@ -201,24 +198,20 @@ objectives_task = Task(
         "6. (Affective - Respond): The trainee actively participates in collaborative learning discussions.\n"
         "7. (Cognitive - Analyze): The trainee compares different instructional design models.\n"
         "8. (Psychomotor - Adapt): The trainee adjusts learning activities to meet learner needs.\n\n"
-
         "**Incorrect Examples (Verb repetition — avoid this):**\n"
         "1. The trainee defines the types of e-learning platforms.\n"
         "2. The trainee defines digital assessment tools.\n"
         "3. The trainee defines active learning strategies.\n"
         "4. The trainee defines blended learning benefits.\n"
         "5. The trainee defines steps of activity design.\n\n"
-
         "**Unclear or Unmeasurable Objectives:**\n"
         "- 'The trainee understands e-learning.' (Vague, not measurable)\n"
         "- 'The trainee learns how to use tools.' (Unclear — which tools?)\n"
         "- 'The trainee becomes an expert in instructional design.' (Unrealistic, not measurable)\n\n"
-
         "**Improved Versions:**\n"
         "- 'The trainee accurately defines e-learning.'\n"
         "- 'The trainee effectively uses LMS tools.'\n"
         "- 'The trainee applies instructional design principles to create a learning unit.'\n\n"
-
         "### Critical Quality Checklist — Verify Before Finalizing Each Objective:\n"
         "1. ✓ Is it clear and accurately expresses the intended outcome?\n"
         "2. ✓ Does it align with a Bloom’s level or learning domain?\n"
@@ -234,7 +227,6 @@ objectives_task = Task(
         "12. ✓ Do all objectives collectively cover knowledge, skills, and attitudes?\n"
         "**13. Verb Check: Have you reused this verb? If yes, can you replace it?**\n"
         "**14. Domain Check: Are the objectives balanced across all three domains?**\n\n"
-
         "### Self-Reflection Requirement\n"
         "After generating all objectives for a unit, pause and evaluate:\n"
         "- Do objectives progress logically through Bloom’s levels?\n"
@@ -244,7 +236,6 @@ objectives_task = Task(
         "- **Do objectives cover all three domains evenly?**\n"
         "- Can an external evaluator assess each objective clearly?\n"
         "- Are all objectives realistic for {audience} and course duration?\n\n"
-
         "### Final Verification: Verb Diversity & Domain Balance\n"
         "**Before submitting your final output:**\n"
         "1. Count how many times each verb appears.\n"
@@ -256,20 +247,16 @@ objectives_task = Task(
         "   - Affective (Attitude): 20–30% of objectives\n"
         "   - Psychomotor (Skills): 20–30% of objectives\n"
         "6. If imbalance occurs, revisit and adjust classifications.\n\n"
-
         "### Domain-Specific Guidelines\n\n"
         "**When writing Cognitive (Knowledge) objectives:**\n"
         "- Use for topics focused on information, understanding, applying, analyzing, evaluating, or creating.\n"
         "- Examples: 'The trainee defines...', 'The trainee compares...', 'The trainee designs...'.\n\n"
-
         "**When writing Affective (Attitude) objectives:**\n"
         "- Use for topics involving values, emotions, interests, or behaviors.\n"
         "- Examples: 'The trainee demonstrates interest in...', 'The trainee participates actively...', 'The trainee commits to...'.\n\n"
-
         "**When writing Psychomotor (Skills) objectives:**\n"
         "- Use for topics requiring physical, technical, or procedural performance.\n"
         "- Examples: 'The trainee practices...', 'The trainee performs...', 'The trainee innovates...'.\n\n"
-
         "### Final Important Notes\n"
         "- **Top Priority:** Verb diversity and balanced domain distribution.\n"
         "- **Quality over quantity:** One well-crafted, diverse objective is better than several repetitive ones.\n"
@@ -282,7 +269,7 @@ objectives_task = Task(
             {
             "unit": "Unit title",
             "unit_description": "Brief summary of the unit scope",
-            "subtopic": "subtopic title",
+            "subtopic": "Subtopic(Axis) title",
             "module_description": "Brief summary of what this subtopic covers",
             "level": "Bloom's level assigned based on subtopic analysis",
             "verbs": ["verb1", "verb2", "verb3"],
@@ -292,5 +279,5 @@ objectives_task = Task(
     }""",
     output_json=ObjectivesOutput,
     agent=objectives_generator,
-    human_input=False
-)
+    human_input=False,
+)

agents/analysis_phase/outcomes.py

@@ -298,5 +298,6 @@ outcomes_task = Task(
       ],
     }""",
     agent=outcomes_generator,
+    output_json=OutcomesOutput,
     human_input=False,
 )