Interactive Handbook of Knowledge Elicitation Techniques (RKEHAC)

An interactive, community-driven Astro site for selecting knowledge elicitation techniques based on PACT context: People, Activities, Context, and Technology.

The handbook combines human-readable technique pages with machine-readable RDF/Turtle metadata so the same content can support both browsing and automated agent workflows.

Features

• PACT-based filtering with collapsible criteria panels and live active-count indicators.
• Astro Content Collections with schema validation through astro/zod and Zod.
• Technique pages with downloadable .ttl metadata files.
• Responsive UI built with Astro and Tailwind CSS.

Tech Stack

• Astro
• Preact for client-side interactivity
• Tailwind CSS
• Zod via astro/zod
• Astro Content Collections

Project Structure

src/
  components/
    FilteringEngine.astro
  content/
    techniques/
      *.md
  content.config.ts
  layouts/
    Layout.astro
  pages/
    index.astro
    about.astro
    techniques/[slug].astro
public/
  images/
  ttl/

Getting Started

Prerequisites

• Node.js 18.17 or newer

Install

git clone https://github.com/your-organization/rke-techniques.git
cd rke-techniques
npm install

Run locally

npm run dev

Astro starts a local dev server at http://localhost:4321.

Build for production

npm run build

This generates the static site in dist/.

Adding a Technique

Add a new Markdown file under src/content/techniques/ and include frontmatter that matches the schema in src/content.config.ts.

---
title: "My New Technique"
short_desc: "A brief description of the technique."
image: "/images/my-new-technique.jpg"
tags: ["qualitative", "verbalization"]
rdf_file: "/ttl/my-new-technique.ttl"

people:
  memory: "moderate (5 - 9)"
  cognitive_orientation: "abstract thinker"
  age_group: "adult (18-64)"
  domain_expertise: "intermediate"
  technical_proficiency: "basic"
  multilinguality: "monolingual"

activities:
  goal_orientation: "reflective"
  frequent_task_repetitions: false
  parallel_tasks: true
  type_of_cognitive_work: "skilled"
  type_of_physical_work: "routine"
  social_structure: "collaborative"
  duration: "5 - 30 min"

contexts:
  comfort_lighting: false
  ambient_noise: "headphones needed"
  role: "Informed"
  location_characteristics: "clean and safe"
  time_pressure: false
  available_documentation: false
  mode_of_communication: "asynchronous"

technologies:
  is_stationary: false
  internet_access: false
  visual_input: false
  aural_input: true
  tactile_input: false
  visual_output: false
  aural_output: true
  tactile_output: false
  automation_level: "no automation"
---

Background

This project was developed through the RKEHAC workshop series and is partly motivated by the REXPEK project, which focuses on capturing and reproducing expert knowledge in industrial settings.

License

MIT