rhachet-roles-bhrain 0.2.0 → 0.5.1

package/dist/roles/thinker/skills/brief.demonstrate/.demo/user.journey.roadtrip.v2025_08_27.i5.md

@@ -0,0 +1,47 @@
+# 🧩 .brief.demo: `user journey` via `walkthrough` = `a road tripper planning a route with a digital map for scenic stops`
+
+## 💡 Concept
+
+A user journey is the complete experience a user has when interacting with a product or service, from initial discovery through usage and beyond. It maps every touchpoint and path a user may take, often represented visually to understand and improve user experiences.
+
+## ❓ Question
+
+> How does a road tripper plan a route with a digital map for scenic stops?
+
+## 📌 Walkthrough: Planning a Scenic Road Trip with a Digital Map
+
+### 📌.📖 What
+
+> What does the road trip planning journey involve?
+
+1. **Preparation Phase**
+   - **Define Goals**: The road tripper determines the primary goal of the trip (e.g., visiting national parks, coastal drives).
+   - **Select Tools**: They choose a digital mapping tool (e.g., Google Maps, Waze) for route planning, considering features like traffic updates, offline maps, and user reviews.
+
+2. **Route Planning Phase**
+   - **Initial Route Input**: The road tripper inputs starting point and destination into the mapping tool.
+   - **Customizing the Path**: They explore suggested routes, comparing distance, time, and scenic detour options.
+   - **Scenic Stops Identification**: Using the map’s search features, they identify scenic spots along the route, such as trails, overlooks, and local attractions.
+   - **Incorporate Stops**: Selected stops are added to the itinerary, balancing desired locations with travel time.
+
+3. **Logistical Coordination**
+   - **Accommodation Search**: Based on route and stops, find accommodations for overnight stays, factoring in proximity to scenic locations.
+   - **Optimize for Time and Experience**: Adjust departure times for optimal arrival at stops during peak scenic conditions (e.g., sunset views).
+   - **Resource Planning**: Check for necessary resources (e.g., fuel stations, rest areas) along the planned route.
+
+4. **Execution Phase**
+   - **Real-Time Navigation**: During the trip, they use GPS for real-time updates and re-routing if needed due to traffic or spontaneous detours.
+   - **Experience Amplification**: Leverage map features like user reviews and photos to enhance visits to planned scenic stops.
+
+### 📌.🔍 How
+
+> How does this planning exemplify a user journey?
+
+This user journey exemplifies the concept through the following elements:
+
+- **Touchpoints Mapping**: Every interaction with the digital map, from initial search to real-time navigation, is a touchpoint designed for seamless user experience.
+- **Goal-Oriented Interaction**: The journey is aligned with the user’s goal of exploring scenic stops, driving their engagement and decision-making processes.
+- **Iterative Path Customization**: The use of real-time data and user feedback loops within the digital tool allows for dynamic and responsive journey customization, enhancing user satisfaction.
+- **Experience Personalization**: Incorporates personalized preferences for scenic routes versus faster routes, illustrating user-centric design.
+
+This walkthrough comprehensively captures how the digital mapping tool facilitates a meaningful user journey for road trippers focusing on scenic stops.

package/dist/roles/thinker/skills/brief.demonstrate/.demo/user.journey.roadtrip.v2025_08_27.i6.md

@@ -0,0 +1,53 @@
+# 🧩 .brief.demo: `user journey` via `walkthrough`
+
+## 💡 Concept
+
+A user journey is the path a user takes when interacting with a service or product to achieve a specific goal, mapped out to understand user experiences, touchpoints, and obstacles.
+
+## ❓ Question
+
+> How can a user journey be demonstrated via a walkthrough?
+
+## 📌 Walkthrough: A Road Tripper Planning a Route with a Digital Map for Scenic Stops
+
+### 📌.📖 What
+
+> What is the scenario?
+
+- **Context**: A road tripper named Alex uses a digital map service to plan a route featuring scenic stops across the country.
+- **Purpose**: To ensure the journey is enjoyable, with opportunities to experience nature, culture, and landmarks.
+- **Tools**: A smartphone with a digital map application loaded with features like route planning, attraction highlights, and user reviews.
+
+### Key Steps in the Walkthrough:
+
+1. **Initial Planning**
+   - Alex opens the digital map application and inputs the destination city.
+   - The app displays multiple route options with estimated travel times and scenic ratings.
+
+2. **Route Selection**
+   - Alex selects a route optimized for scenic beauty, as indicated by user reviews and attraction icons along the map.
+   - The chosen route includes highlights like National Parks, quaint towns, and roadside attractions.
+
+3. **Customization**
+   - Alex uses the "Add Stops" feature to integrate recommended scenic viewpoints and rest areas into the trip.
+   - The map recalculates the journey with these additional waypoints, showing updated travel times.
+
+4. **Live Navigation**
+   - During the trip, Alex uses turn-by-turn navigation, which provides audio cues for upcoming attractions.
+   - Real-time traffic updates and road conditions adjust the route dynamically to avoid delays.
+
+5. **Feedback and Reflection**
+   - Post-trip, Alex uses the app to rate the attractions and route experience, contributing to the community insights.
+   - The app prompts Alex to save the trip as a future reference or share with other users planning similar journeys.
+
+### 📌.🔍 How
+
+> How does this walkthrough demonstrate a user journey?
+
+- **Engagement with Technology**: Highlights interaction with the app's features to plan and execute an enriching journey.
+- **User-Centric Design**: Shows how the app assists in optimizing the journey, suggesting alternatives and customizations tailored to user preferences.
+- **Experience Enrichment**: Demonstrates how digital tools enhance the journey by integrating real-time data and community feedback.
+- **Journey Mapping**: Captures the essence of a user journey by following Alex's experiences from planning to execution, reflecting the stages of exploration, decision-making, and reflection.
+- **Feedback Loop**: Illustrates the app's role in creating a seamless experience while encouraging continuous improvement through user insights.
+
+This walkthrough encapsulates the user journey of leveraging technology for enhanced trip experiences, reflecting the interplay between user actions, technology, and feedback mechanisms.

package/dist/roles/thinker/skills/brief.demonstrate/.readme

@@ -0,0 +1,3 @@
+purpose = explain a concept, via demonstration
+
+produces .brief.demo's which can be used to provision context

package/dist/roles/thinker/skills/brief.demonstrate/stepDemonstrate.skill.js

@@ -119,7 +119,7 @@ exports.SKILL_DEMONSTRATE = (0, rhachet_1.genRoleSkill)({
         lookup: {
             apiKeyOpenai: {
                 source: 'process.env',
-                envar: 'PREP_OPENAI_KEY',
+                envar: 'OPENAI_API_KEY',
                 desc: 'the openai key to use',
                 type: 'string',
             },

package/dist/roles/thinker/skills/brief.demonstrate/stepDemonstrate.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepDemonstrate.skill.js","sourceRoot":"","sources":["../../../../../src/roles/thinker/skills/brief.demonstrate/stepDemonstrate.skill.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stepDemonstrate.skill.js","sourceRoot":"","sources":["../../../../../src/roles/thinker/skills/brief.demonstrate/stepDemonstrate.skill.ts"],"names":[],"mappings":"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"}

package/dist/roles/thinker/skills/brief.demonstrate/stepDemonstrate.skill.ts

@@ -0,0 +1,190 @@
+import { enrollThread, genRoleSkill } from 'rhachet';
+import { genArtifactGitFile, getArtifactObsDir } from 'rhachet-artifact-git';
+
+import { genContextLogTrail } from '@src/.test/genContextLogTrail';
+import { genContextStitchTrail } from '@src/.test/genContextStitchTrail';
+import { getContextOpenAI } from '@src/.test/getContextOpenAI';
+
+import { BRIEFS_FOR_DEMONSTRATE, loopDemonstrate } from './stepDemonstrate';
+
+export const SKILL_DEMONSTRATE = genRoleSkill({
+  slug: 'demonstrate',
+  route: loopDemonstrate,
+  threads: {
+    lookup: {
+      output: {
+        source: 'process.argv',
+        char: 'o',
+        desc: 'the output file to write against',
+        type: 'string',
+      },
+      input: {
+        source: 'process.argv',
+        char: 'i',
+        desc: 'the input file to seed from',
+        type: 'string',
+      },
+      goal: {
+        source: 'process.argv',
+        char: 'g',
+        desc: 'the goal of the request',
+        type: '?string',
+      },
+      references: {
+        source: 'process.argv',
+        char: 'f',
+        desc: 'reference files to to use, if any; delimit with commas',
+        type: '?string',
+      },
+      briefs: {
+        source: 'process.argv',
+        char: 'b',
+        desc: 'brief files to to use, if any; delimit with commas',
+        type: '?string',
+      },
+      templates: {
+        source: 'process.argv',
+        char: 'z', // todo: support undefined
+        desc: 'template files to to use, if any; delimit with commas',
+        type: '?string',
+      },
+    },
+    assess: (
+      input,
+    ): input is {
+      output: string;
+      input: string;
+      goal: string;
+      references: string;
+      briefs: string;
+      templates?: string;
+      ask: string;
+    } => typeof input.output === 'string',
+    instantiate: async (input: {
+      output: string;
+      input: string;
+      goal: string;
+      references: string;
+      briefs: string;
+      templates?: string;
+      ask: string;
+    }) => {
+      // declare where all the artifacts will be found
+      const obsDir = getArtifactObsDir({ uri: input.output });
+      const artifacts = {
+        goal: {
+          concept: genArtifactGitFile(
+            { uri: obsDir + '.goal.concept.md' },
+            { versions: true },
+          ),
+          context: genArtifactGitFile(
+            { uri: obsDir + '.goal.context.md' },
+            { versions: true },
+          ),
+        },
+        feedback: genArtifactGitFile(
+          { uri: obsDir + '.feedback.md' },
+          { versions: true },
+        ),
+        'focus.context': genArtifactGitFile(
+          { uri: obsDir + '.focus.context.md' },
+          { versions: true },
+        ),
+        'focus.concept': genArtifactGitFile(
+          { uri: input.output },
+          { versions: true },
+        ),
+        input: genArtifactGitFile({ uri: input.input }, { versions: true }),
+        references:
+          input.references
+            ?.split(',')
+            .filter((uri) => !!uri)
+            .map((reference) =>
+              genArtifactGitFile({ uri: reference }, { access: 'readonly' }),
+            ) ?? [],
+        briefs:
+          input.briefs
+            ?.split(',')
+            .filter((uri) => !!uri)
+            .map((brief) =>
+              genArtifactGitFile({ uri: brief }, { access: 'readonly' }),
+            ) ?? [],
+        templates:
+          input.templates
+            ?.split(',')
+            .filter((uri) => !!uri)
+            .map((template) =>
+              genArtifactGitFile({ uri: template }, { access: 'readonly' }),
+            ) ?? [],
+      };
+
+      // detect the goal of the caller
+      const goalConcept: string = await (async () => {
+        // if goal explicitly defined, use it
+        if (input.goal)
+          return (
+            (
+              await genArtifactGitFile(
+                { uri: input.goal },
+                { access: 'readonly' },
+              ).get()
+            )?.content ?? input.ask
+          );
+
+        // otherwise, assume its the ask
+        return input.ask;
+      })();
+      await artifacts.goal.concept.set({ content: goalConcept });
+
+      return {
+        caller: await enrollThread({
+          role: 'caller',
+          stash: {
+            ask: '',
+            art: {
+              'foci.goal.concept': artifacts.goal.concept,
+              'foci.goal.context': artifacts.goal.context,
+              'foci.input.concept': artifacts.input,
+              feedback: artifacts.feedback,
+              templates: artifacts.templates,
+            },
+            refs: artifacts.references,
+          },
+        }),
+        thinker: await enrollThread({
+          role: 'thinker',
+          stash: {
+            art: {
+              'focus.context': artifacts['focus.context'],
+              'focus.concept': artifacts['focus.concept'],
+            },
+            briefs: [
+              ...artifacts.briefs,
+              ...BRIEFS_FOR_DEMONSTRATE, // flow the demonstrate briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for demonstrate, but thats no biggie
+            ],
+          },
+        }),
+      };
+    },
+  },
+  context: {
+    lookup: {
+      apiKeyOpenai: {
+        source: 'process.env',
+        envar: 'OPENAI_API_KEY',
+        desc: 'the openai key to use',
+        type: 'string',
+      },
+    },
+    assess: (input): input is { apiKeyOpenai: string } =>
+      typeof input.apiKeyOpenai === 'string',
+    instantiate: () => {
+      return {
+        ...getContextOpenAI(),
+        ...genContextLogTrail(),
+        ...genContextStitchTrail(),
+      };
+    },
+  },
+  readme: '',
+});

package/dist/roles/thinker/skills/brief.demonstrate/stepDemonstrate.ts

@@ -0,0 +1,164 @@
+import { UnexpectedCodePathError } from 'helpful-errors';
+import {
+  asStitcherFlat,
+  type GStitcher,
+  genStepImagineViaTemplate,
+  genStitchRoute,
+  genTemplate,
+  getTemplateValFromArtifacts,
+  getTemplateVarsFromRoleInherit,
+  type RoleContext,
+  type Threads,
+} from 'rhachet';
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import { withRetry, withTimeout } from 'wrapper-fns';
+
+import type { Focus } from '@src/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+import { type ContextOpenAI, sdkOpenAi } from '@src/access/sdk/sdkOpenAi';
+import { genLoopFeedback } from '@src/domain.operations/artifact/genLoopFeedback';
+import { genStepArtSet } from '@src/domain.operations/artifact/genStepArtSet';
+import { getThinkerBriefs } from '@src/roles/thinker/getThinkerBrief';
+
+// exported so that we can pass them through to <ponder> too
+export const BRIEFS_FOR_DEMONSTRATE = getThinkerBriefs([
+  'trait.ocd.md',
+  'cognition/cog401.questions.._.md',
+  'cognition/cog000.overview.and.premise.md',
+  'cognition/cog101.concept.treestruct._.md',
+  'cognition/cog201.cortal.focus.p1.definition.md',
+  'cognition/cog301.traversal.1.motion.primitives._.md',
+  'cognition/cog401.questions.._.md',
+  'cognition/cog401.questions.2.1.primitives.rough._.md',
+  'cognition/cog201.cortal.focus.p2.breadth.md',
+  'cognition/cog301.traversal.1.motion.primitives.breadth.md',
+  'cognition/cog301.traversal.1.motion.primitives.breadth.vary.md',
+  'librarian.tactics/[brief].verbiage.outline.over.narrative.md',
+  // 'librarian.tactics/<demonstrate>._.[article].frame.tactical.md',
+  // 'librarian.tactics/<demonstrate>._.[article].frame.colloquial.md',
+  // 'librarian.tactics/<demonstrate>.tactics.[catalog].md',
+  'librarian.tactics/<demonstrate>._.[article].frame.colloquial.i2.by_grok.md',
+  'librarian.tactics/<demonstrate>.variants.[catalog].md',
+  // 'librarian.tactics/<demonstrate>.variants.contrast.[demo].usecase.vs_userjourney.by_chatgpt.md',
+  'librarian.tactics/<demonstrate>.variants.example.[demo].tea.darjeeling.by_grok.md',
+  'librarian.tactics/<demonstrate>.variants.counter.[demo].walkability.phoenix.by_chargpt.md',
+  'librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_chatgpt.i3.md',
+  'librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_grok.i2.md',
+  'librarian.tactics/<demonstrate>.variants.example.structure.[article].i2.md',
+  'librarian.tactics/<demonstrate>.variants.example.[lesson].howto.md',
+]);
+
+type StitcherDesired = GStitcher<
+  Threads<{
+    caller: RoleContext<
+      'caller',
+      {
+        art: {
+          feedback: Artifact<typeof GitFile>;
+          'foci.goal.concept': Focus['concept'];
+          'foci.goal.context': Focus['context'];
+          'foci.input.concept': Focus['concept'];
+          templates: Artifact<typeof GitFile>[]; // more of a librarian input ?
+        };
+        refs: Artifact<typeof GitFile>[];
+      }
+    >;
+    thinker: RoleContext<
+      'thinker',
+      {
+        art: {
+          'focus.concept': Focus['concept'];
+          'focus.context': Focus['context'];
+        };
+        briefs: Artifact<typeof GitFile>[];
+      }
+    >;
+  }>,
+  ContextOpenAI & GStitcher['context'],
+  { content: string }
+>;
+
+const template = genTemplate<StitcherDesired['threads']>({
+  ref: { uri: __filename.replace('.ts', '.template.md') },
+  getVariables: async ({ threads }) => ({
+    ...(await getTemplateVarsFromRoleInherit({ thread: threads.thinker })),
+
+    guide: {
+      goal:
+        (await threads.caller.context.stash.art['foci.goal.concept'].get())
+          ?.content ||
+        UnexpectedCodePathError.throw('goal not declared', {
+          art: threads.caller.context.stash.art['foci.goal.concept'],
+        }),
+      feedback:
+        (await threads.caller.context.stash.art.feedback.get())?.content || '',
+    },
+
+    focus: {
+      context:
+        (await threads.thinker.context.stash.art['focus.context'].get())
+          ?.content ||
+        (await threads.caller.context.stash.art['foci.goal.context'].get()) // fallback to @[caller].focus[goal].context
+          ?.content ||
+        '',
+      concept:
+        (await threads.thinker.context.stash.art['focus.concept'].get())
+          ?.content || '',
+    },
+
+    seed: {
+      concept:
+        (await threads.caller.context.stash.art['foci.input.concept'].get())
+          ?.content ||
+        UnexpectedCodePathError.throw('input not declared', {
+          art: threads.caller.context.stash.art['foci.input.concept'],
+        }),
+    },
+
+    skill: {
+      briefs: await getTemplateValFromArtifacts({
+        artifacts: [
+          ...BRIEFS_FOR_DEMONSTRATE,
+          ...threads.thinker.context.stash.briefs,
+        ],
+      }),
+    },
+
+    references: await getTemplateValFromArtifacts({
+      artifacts: threads.caller.context.stash.refs,
+    }),
+
+    templates: await getTemplateValFromArtifacts({
+      artifacts: [...threads.caller.context.stash.art.templates],
+    }),
+  }),
+});
+
+const stepImagine = genStepImagineViaTemplate<StitcherDesired>({
+  slug: '@[thinker]<demonstrate>',
+  stitchee: 'thinker',
+  readme: '',
+  template,
+  imagine: withRetry(
+    withTimeout(sdkOpenAi.imagine, { threshold: { seconds: 60 } }), // allow up to 60 sec, for longer files
+  ),
+});
+
+const stepPersist = genStepArtSet({
+  stitchee: 'thinker',
+  artee: 'focus.concept',
+});
+
+export const stepDemonstrate = asStitcherFlat<StitcherDesired>(
+  genStitchRoute({
+    slug: '@[thinker]<demonstrate>',
+    readme: '@[thinker]<demonstrate> -> [article]',
+    sequence: [stepImagine, stepPersist],
+  }),
+);
+
+export const loopDemonstrate = genLoopFeedback({
+  stitchee: 'thinker',
+  artee: 'focus.concept',
+  repeatee: stepDemonstrate,
+});

package/dist/roles/thinker/skills/khue.cluster/.demo/user.journeys.input1.cluster.v2025_08_17.i1.md

@@ -0,0 +1,72 @@
+[
+  {
+    "label": "E-commerce and Shopping",
+    "members": [
+      "a fan purchasing merchandise and concert tickets through a band’s fan club portal",
+      "a shopper browsing fashion trends and creating a personalized outfit on a clothing retailer's site",
+      "a traveler planning and booking a multi-stop vacation using a travel aggregator",
+      "a subscriber managing subscriptions and preferences through a digital newspaper site",
+      "a foodie exploring recipes and meal planning with an online culinary community"
+    ],
+    "rationale": "These activities involve purchasing goods, services, or subscriptions online, often tailored to personal preferences and interests."
+  },
+  {
+    "label": "Community Interaction and Engagement",
+    "members": [
+      "a hobbyist engaging with a community forum to share projects and seek advice",
+      "a team collaborating and tracking project tasks using a productivity software suite",
+      "an artist sharing portfolio works and engaging with followers on social media",
+      "a researcher accessing databases and compiling data for academic work via a university portal"
+    ],
+    "rationale": "These scenarios focus on engaging and collaborating within online communities to share ideas, manage tasks, and disseminate information."
+  },
+  {
+    "label": "Entertainment and Leisure",
+    "members": [
+      "a gamer unlocking achievements and in-game rewards while progressing through a video game",
+      "a subscriber exploring exclusive content and engaging with creators on a streaming platform",
+      "a traveler planning and booking a multi-stop vacation using a travel aggregator"
+    ],
+    "rationale": "These activities are centered around entertainment, leisure, and exploration, often through digital and interactive platforms."
+  },
+  {
+    "label": "Financial and Investment Management",
+    "members": [
+      "an individual researching and choosing a financial investment through an online brokerage platform",
+      "a donor contributing to multiple causes and managing donations through a charitable giving platform"
+    ],
+    "rationale": "Both actions involve financial decision-making and management facilitated by digital platforms."
+  },
+  {
+    "label": "Professional and Career Development",
+    "members": [
+      "a job seeker applying and interviewing for positions via an employment website",
+      "an entrepreneur submitting a business idea for evaluation via a startup accelerator program",
+      "a writer drafting and publishing posts using a blogging platform's features"
+    ],
+    "rationale": "These activities relate to career advancement and professional contributions facilitated through online platforms."
+  },
+  {
+    "label": "Health and Wellness",
+    "members": [
+      "a fitness enthusiast scheduling and tracking workouts with a mobile fitness application",
+      "a patient exploring healthcare options and scheduling appointments through a telehealth service"
+    ],
+    "rationale": "These tasks focus on managing personal health and wellness through the use of technology and digital services."
+  },
+  {
+    "label": "Real Estate and Property Management",
+    "members": [
+      "a visitor comparing neighborhoods and selecting a property on a real estate website",
+      "a parent managing school-related activities and communication through a virtual learning environment"
+    ],
+    "rationale": "These scenarios involve evaluating properties and managing activities related to real estate and education, often facilitated by digital tools."
+  },
+  {
+    "label": "Technology Setup and Management",
+    "members": [
+      "a new user learning about and setting up a smart home device using the manufacturer's mobile app"
+    ],
+    "rationale": "This activity involves setting up technology through a mobile app for personal convenience and management."
+  }
+]

package/dist/roles/thinker/skills/khue.cluster/.demo/user.journeys.input1.cluster.v2025_08_17.i2.md

@@ -0,0 +1,53 @@
+[
+    {
+        "label": "Online Commerce and Transactions",
+        "members": [
+            "an individual researching and choosing a financial investment through an online brokerage platform",
+            "a visitor comparing neighborhoods and selecting a property on a real estate website",
+            "a fan purchasing merchandise and concert tickets through a band’s fan club portal",
+            "a shopper browsing fashion trends and creating a personalized outfit on a clothing retailer's site",
+            "a traveler planning and booking a multi-stop vacation using a travel aggregator",
+            "a job seeker applying and interviewing for positions via an employment website",
+            "a donor contributing to multiple causes and managing donations through a charitable giving platform"
+        ],
+        "rationale": "These activities involve making purchases or selecting services digitally, often involving research, comparison, and transaction execution on online platforms."
+    },
+    {
+        "label": "Digital Content and Community Engagement",
+        "members": [
+            "a new user learning about and setting up a smart home device using the manufacturer's mobile app",
+            "a hobbyist engaging with a community forum to share projects and seek advice",
+            "a parent managing school-related activities and communication through a virtual learning environment",
+            "a subscriber exploring exclusive content and engaging with creators on a streaming platform",
+            "an artist sharing portfolio works and engaging with followers on social media",
+            "a writer drafting and publishing posts using a blogging platform's features",
+            "a foodie exploring recipes and meal planning with an online culinary community"
+        ],
+        "rationale": "These actions focus on engaging with digital content, learning, sharing, and interacting with communities through various online platforms."
+    },
+    {
+        "label": "Productivity and Professional Development",
+        "members": [
+            "an entrepreneur submitting a business idea for evaluation via a startup accelerator program",
+            "a researcher accessing databases and compiling data for academic work via a university portal",
+            "a team collaborating and tracking project tasks using a productivity software suite",
+            "a fitness enthusiast scheduling and tracking workouts with a mobile fitness application",
+            "a patient exploring healthcare options and scheduling appointments through a telehealth service"
+        ],
+        "rationale": "These activities pertain to professional development, personal productivity, collaboration, and managing health and wellness, often using specialized online platforms."
+    },
+    {
+        "label": "Entertainment and Recreation",
+        "members": [
+            "a gamer unlocking achievements and in-game rewards while progressing through a video game"
+        ],
+        "rationale": "This activity involves engaging with digital entertainment platforms for leisure and recreation, often focusing on the gaming experience."
+    },
+    {
+        "label": "Service Management and Personalization",
+        "members": [
+            "a subscriber managing subscriptions and preferences through a digital newspaper site"
+        ],
+        "rationale": "This activity involves personalized management and customization of service subscriptions to meet the user's preferences and needs."
+    }
+]